API Documentation

Feeling RESTful?

API v2 » users/show (GET)

Description

This method returns information on a specified user. BETA

URL

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

Available Formats

xml, json, jsonp

HTTP Method

GET

Requires Authentication

False

Parameters

  • username (Required): The twitter screenname of the user
  • page (Optional): The page of photos to return (max 20 per page)

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<user>
	    <id>3</id>
	    <twitter_id>12925072</twitter_id>
	    <username>TwitPic</username>
	    <name>TwitPic</name>
	    <location>Delivering your photos</location>
	    <website>http://twitpic.com</website>
	    <bio>Share photos on twitter - follow @noaheverett for other unofficial news</bio>
	    <avatar_url>http://a1.twimg.com/profile_images/50582482/twitpic-icon_normal.gif</avatar_url>
	    <profile_background_color>DAFDFF</profile_background_color>
	    <profile_text_color>000000</profile_text_color>
	    <profile_link_color>097BE6</profile_link_color>
	    <profile_sidebar_fill_color>FAFAFA</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>2008-02-05 16:42:30</timestamp>
	    <photo_count>143</photo_count>
	    <events />
	    <images>
	        <image>
	            <id>808234</id>
	            <short_id>hbmy</short_id>
	            <user_id>3</user_id>
	            <source>site</source>
	            <message>Photo of 2 (there are more, just not shown) of the new servers in my(@noaheverett) apartment as requested =) </message>
	            <views>2250</views>
	            <width>600</width>
	            <height>800</height>
	            <size>129537</size>
	            <type>jpg</type>
	            <status_id />
	            <in_reply_to_status_id />
	            <in_reply_to_user_id />
	            <location />
	            <timestamp>2008-10-20 22:05:24</timestamp>
	            <application />
	            <user />
	            <events />
	            <faces />
	            <comments />
	        </image>
	    </images>
	</user>

Sample JSON Response

	
	{
	   "id":"3",
	   "twitter_id":"12925072",
	   "username":"TwitPic",
	   "name":"TwitPic",
	   "location":"Delivering your photos",
	   "website":"http:\/\/twitpic.com",
	   "bio":"Share photos on twitter - follow @noaheverett for other unofficial news",
	   "avatar_url":"http:\/\/a1.twimg.com\/profile_images\/50582482\/twitpic-icon_normal.gif",
	   "profile_background_color":"DAFDFF",
	   "profile_text_color":"000000",
	   "profile_link_color":"097BE6",
	   "profile_sidebar_fill_color":"FAFAFA",
	   "profile_background_image_url":"http:\/\/s.twimg.com\/a\/1271213136\/images\/themes\/theme1\/bg.png",
	   "profile_background_tile":"0",
	   "utc_offset":null,
	   "geo_enabled":null,
	   "public_updates":"1",
	   "public_tagging":"0",
	   "banned":"0",
	   "timestamp":"2008-02-05 16:42:30",
	   "photo_count":"143",
	   "events":null,
	   "images":[
	      {
	         "id":"808234",
	         "short_id":"hbmy",
	         "user_id":"3",
	         "source":"site",
	         "message":"Photo of 2 (there are more, just not shown) of the new servers in my(@noaheverett) apartment as requested =) ",
	         "views":"2255",
	         "width":"600",
	         "height":"800",
	         "size":"129537",
	         "type":"jpg",
	         "status_id":null,
	         "in_reply_to_status_id":null,
	         "in_reply_to_user_id":null,
	         "location":"",
	         "timestamp":"2008-10-20 22:05:24",
	         "application":null,
	         "user":null,
	         "faces":null,
	         "comments":null,
	         "events":null
	      },
	      {
	         "id":"8156",
	         "short_id":"6ak",
	         "user_id":"3",
	         "source":"site",
	         "message":"Screenshot of the new version of TwitPic",
	         "views":"1245",
	         "width":"600",
	         "height":"395",
	         "size":"79337",
	         "type":"gif",
	         "status_id":null,
	         "in_reply_to_status_id":null,
	         "in_reply_to_user_id":null,
	         "location":"",
	         "timestamp":"2008-04-03 18:16:54",
	         "application":null,
	         "user":null,
	         "faces":null,
	         "comments":null,
	         "events":null
	      }
	   ],
	   "places":null
	}

Example CURL Command

	curl -v "http://api.twitpic.com/2/users/show.json?username=twitpic"