Description
This method returns information on a specified image or video.
If the requested media is a video, the API response will contain video information in the 'video' item.
URL
http://api.twitpic.com/2/media/show.format
Available Formats
xml, json, jsonp
HTTP Method
GET
Requires Authentication
False
Parameters
- id (Required): The id of the image
Responses
Sample XML Response
<?xml version="1.0" encoding="UTF-8"?> <image> <id>86296815</id> <short_id>1fdn1r</short_id> <user_id>1</user_id> <source>phone</source> <message>Image Message</message> <views>292</views> <width>2048</width> <height>1536</height> <size>999999</size> <type>jpg</type> <status_id /> <in_reply_to_status_id /> <in_reply_to_user_id /> <location /> <timestamp>2010-04-13 20:30:21</timestamp> <user> <id>1</id> <twitter_id>1234232</twitter_id> <username>twitpic</username> <name>Twitpic</name> <location>Charleston, SC</location> <website>http://twitpic.com</website> <bio></bio> <avatar_url></avatar_url> <profile_background_color>eeeeee</profile_background_color> <profile_text_color>000000</profile_text_color> <profile_link_color>3080CB</profile_link_color> <profile_sidebar_fill_color>f5f5f5</profile_sidebar_fill_color> <profile_background_image_url></profile_background_image_url> <profile_background_tile>0</profile_background_tile> <utc_offset>-18000</utc_offset> <geo_enabled>1</geo_enabled> <public_updates>1</public_updates> <public_tagging>0</public_tagging> <banned>0</banned> <timestamp>2008-02-05 16:20:03</timestamp> <events /> <images /> </user> <comments> <comment> <id>12345</id> <user_id>12345</user_id> <message>Comment Message</message> <timestamp>2010-04-13 20:34:09</timestamp> <user> <id>12345</id> <twitter_id>12345</twitter_id> <username>Twitpic</username> <name>Twitpic User</name> <location></location> <website></website> <bio></bio> <avatar_url></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></profile_background_image_url> <profile_background_tile>0</profile_background_tile> <utc_offset /> <geo_enabled /> <public_updates>1</public_updates> <public_tagging>0</public_tagging> <banned>0</banned> <timestamp>2010-03-21 21:25:35</timestamp> <events /> <images /> </user> </comment> </comments> <application /> <events> <event> <id>12</id> <user_id>1</user_id> <name>Chirp / San Francisco</name> <description>From my trip to San Francisco for Twitter's Chirp conference</description> <timestamp>2010-06-01 17:01:00</timestamp> </event> </events> <faces /> </image>
Sample JSON Response
{
"id":"86296815",
"short_id":"1fdn1r",
"user_id":"1",
"source":"phone",
"message":"Hello San Francisco...we meet again",
"views":722,
"width":"2048",
"height":"1536",
"size":"999999",
"type":"jpg",
"status_id":null,
"in_reply_to_status_id":null,
"in_reply_to_user_id":null,
"location":"",
"timestamp":"2010-04-13 20:30:21",
"user":{
"id":"1",
"twitter_id":"13058232",
"username":"noaheverett",
"name":"Noah Everett",
"location":"Charleston, SC",
"website":"http:\/\/twitpic.com",
"bio":"The nice guy that finished first - founder of Twitpic",
"avatar_url":"http:\/\/a1.twimg.com\/profile_images\/305802420\/new-head-shot_normal.jpg",
"profile_background_color":"eeeeee",
"profile_text_color":"000000",
"profile_link_color":"3080CB",
"profile_sidebar_fill_color":"f5f5f5",
"profile_background_image_url":"http:\/\/s.twimg.com\/a\/1278188204\/images\/themes\/theme1\/bg.png",
"profile_background_tile":"0",
"utc_offset":"-18000",
"geo_enabled":"1",
"public_updates":"1",
"public_tagging":"0",
"banned":"0",
"timestamp":"2008-02-05 16:20:03",
"events":null,
"images":null,
"places":null
},
"comments":[
{
"id":"12345",
"user_id":"1234",
"message":"Great photo!",
"timestamp":"2010-06-29 02:53:52",
"user":{
"id":"1234",
"twitter_id":"9876",
"username":"twitpicuser",
"name":"User",
"location":"",
"website":"",
"bio":"",
"avatar_url":"http:\/\/s.twimg.com\/a\/1277506381\/images\/default_profile_6_normal.png",
"profile_background_color":"9ae4e8",
"profile_text_color":"000000",
"profile_link_color":"0000ff",
"profile_sidebar_fill_color":"e0ff92",
"profile_background_image_url":"http:\/\/s.twimg.com\/a\/1277506381\/images\/themes\/theme1\/bg.png",
"profile_background_tile":"0",
"utc_offset":"0",
"geo_enabled":"0",
"public_updates":"0",
"public_tagging":"1",
"banned":"0",
"timestamp":"2010-06-19 01:47:20",
"events":null,
"images":null,
"places":null
}
}
],
"events":[
{
"id":"12",
"user_id":"1",
"name":"Chirp \/ San Francisco",
"description":"From my trip to San Francisco for Twitter's Chirp conference",
"timestamp":"2010-06-01 17:01:00"
}
],
"application":null,
"faces":null
}
Example CURL Command
curl -v "http://api.twitpic.com/2/media/show.json?id=1fdn1r"