• Main Site
• Documentation
• Login

Description

This method returns all images in which the specified user is face tagged. BETA

URL

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

Available Formats

xml, json

HTTP Method

POST

Requires Authentication

True

Header Example

	
	OAuth realm="http://api.twitter.com/", 
	oauth_consumer_key="GDdmIQH6jhtmLUypg82g", 
	oauth_signature_method="HMAC-SHA1", 
	oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", 
	oauth_timestamp="1272325550", 
	oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", 
	oauth_version="1.0", 
	oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"	

X-Auth-Service-Provider (Required)

https://api.twitter.com/1/account/verify_credentials.json

Parameters

• key (Required): The API key of the calling application/website
• user (Required): The username of the user

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<user>
	    <id>5081301</id>
	    <twitter_id>16984249</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/1278630136/images/default_profile_2_normal.png</avatar_url>
	    <profile_background_color>9ae4e8</profile_background_color>
	    <profile_text_color>000000</profile_text_color>
	    <profile_link_color>0000ff</profile_link_color>
	    <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
	    <profile_background_image_url>http://s.twimg.com/a/1278630136/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>1</public_updates>
	    <public_tagging>0</public_tagging>
	    <banned>0</banned>
	    <timestamp>2009-10-30 17:43:17</timestamp>
	    <events />
	    <images>
	        <image>
	            <id>114311604</id>
	            <short_id>1w23ec</short_id>
	            <user_id>5081301</user_id>
	            <source>site</source>
	            <message>T3</message>
	            <views>0</views>
	            <width>2048</width>
	            <height>1536</height>
	            <size>1608006</size>
	            <type>jpg</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-06-12 07:04:13</timestamp>
	            <application />
	            <user />
	            <comments />
	            <events />
	            <faces>
	                <face>
	                    <id>24858</id>
	                    <media_id>114311604</media_id>
	                    <name>Test</name>
	                    <twitter_username>twitpicuser</twitter_username>
	                    <top_coord>129</top_coord>
	                    <left_coord>242</left_coord>
	                    <width>100</width>
	                    <height>100</height>
	                </face>
	            </faces>
	        </image>
	        <image>
	            <id>115585432</id>
	            <short_id>1wteag</short_id>
	            <user_id>5081301</user_id>
	            <source>site</source>
	            <message>Test again</message>
	            <views>20</views>
	            <width>3246</width>
	            <height>2169</height>
	            <size>2646071</size>
	            <type>jpg</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-06-14 19:38:40</timestamp>
	            <application />
	            <user />
	            <comments />
	            <events />
	            <faces>
	                <face>
	                    <id>40595</id>
	                    <media_id>115585432</media_id>
	                    <name>Test</name>
	                    <twitter_username>twitpicuser</twitter_username>
	                    <top_coord>30</top_coord>
	                    <left_coord>374</left_coord>
	                    <width>100</width>
	                    <height>100</height>
	                </face>
	            </faces>
	        </image>
	    </images>
	    <places />
	</user>	

Example CURL Command

	curl -v -H 'X-Auth-Service-Provider: https://api.twitter.com/1/account/verify_credentials.json' -H 'X-Verify-Credentials-Authorization: OAuth realm="http://api.twitter.com/", oauth_consumer_key="GDdmIQH6jhtmLUypg82g", oauth_signature_method="HMAC-SHA1", oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", oauth_timestamp="1272325550", oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", oauth_version="1.0", oauth_signature="U1obTfE7Rs9J1kafTGwufLJdspo%3D"' -F "key=098f6bcd4621d373cade4e832627b4f6" -F "user=twitpicuser" http://api.twitpic.com/2/faces/show.json