API Documentation

Feeling RESTful?

API v2 » tags/show (GET)

Description

This method returns all images with the specified tag BETA

Note: Tags are separate from Face Tags. Tags are used for searching purposes and are often grabbed automatically from hashtags present in tweets.

URL

http://api.twitpic.com/2/tags/show.format

Available Formats

xml, json, jsonp

HTTP Method

GET

Requires Authentication

False

Parameters

  • tag (Required): The tag to search for (without a leading #)

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<tag>
	    <id>856518</id>
	    <name>win</name>
	    <images>
	        <image>
	            <id>142</id>
	            <short_id>3y</short_id>
	            <user_id>1</user_id>
	            <source>api</source>
	            <message />
	            <views>0</views>
	            <width>220</width>
	            <height>84</height>
	            <size>8722</size>
	            <type>png</type>
	            <status_id>0</status_id>
	            <in_reply_to_status_id>0</in_reply_to_status_id>
	            <in_reply_to_user_id>0</in_reply_to_user_id>
	            <location />
	            <timestamp>2010-07-13 15:20:02</timestamp>
	            <application />
	            <user>
	                <id>1</id>
	                <twitter_id>1234</twitter_id>
	                <username>twitpicuser</username>
	                <name>twitpicuser</name>
	                <location>The Interwebs</location>
	                <website>http://twitpic.com</website>
	                <bio>Hi :)</bio>
	                <avatar_url>http://s.twimg.com/a/1278960292/images/default_profile_2_normal.png</avatar_url>
	                <profile_background_color>C0DEED</profile_background_color>
	                <profile_text_color>333333</profile_text_color>
	                <profile_link_color>0084B4</profile_link_color>
	                <profile_sidebar_fill_color>DDEEF6</profile_sidebar_fill_color>
	                <profile_background_image_url>http://s.twimg.com/a/1278960292/images/themes/theme1/bg.png</profile_background_image_url>
	                <profile_background_tile>0</profile_background_tile>
	                <utc_offset>-21600</utc_offset>
	                <geo_enabled>1</geo_enabled>
	                <public_updates>0</public_updates>
	                <public_tagging>1</public_tagging>
	                <banned>0</banned>
	                <timestamp>2010-06-10 16:00:04</timestamp>
	                <events />
	                <images />
	                <places />
	            </user>
	            <faces />
	            <comments />
	            <events />
	            <tags />
	        </image>
	    </images>
	</tag>	

Sample JSON Response

	
	{
	   "id":"856518",
	   "name":"win",
	   "images":[
	      {
	         "id":"142",
	         "short_id":"3y",
	         "user_id":"1",
	         "source":"api",
	         "message":"",
	         "views":"0",
	         "width":"220",
	         "height":"84",
	         "size":"8722",
	         "type":"png",
	         "status_id":"0",
	         "in_reply_to_status_id":"0",
	         "in_reply_to_user_id":"0",
	         "location":"",
	         "timestamp":"2010-07-13 15:20:02",
	         "application":null,
	         "user":{
	            "id":"1",
	            "twitter_id":"1234",
	            "username":"twitpicuser",
	            "name":"twitpicuser",
	            "location":"The Interwebs",
	            "website":"http:\/\/twitpic.com",
	            "bio":"Hi :)",
	            "avatar_url":"http:\/\/s.twimg.com\/a\/1278960292\/images\/default_profile_2_normal.png",
	            "profile_background_color":"C0DEED",
	            "profile_text_color":"333333",
	            "profile_link_color":"0084B4",
	            "profile_sidebar_fill_color":"DDEEF6",
	            "profile_background_image_url":"http:\/\/s.twimg.com\/a\/1278960292\/images\/themes\/theme1\/bg.png",
	            "profile_background_tile":"0",
	            "utc_offset":"-21600",
	            "geo_enabled":"1",
	            "public_updates":"0",
	            "public_tagging":"1",
	            "banned":"0",
	            "timestamp":"2010-06-10 16:00:04",
	            "events":null,
	            "images":null,
	            "places":null
	         },
	         "faces":null,
	         "comments":null,
	         "events":null,
	         "tags":null
	      }
	   ]
	}	

Example CURL Command

	curl -v "http://api.twitpic.com/2/tags/show.json?tag=win"