API Documentation

Feeling RESTful?

API v2 » place/show (GET)

Description

This method returns all photos taken at the specified location. BETA

URL

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

Available Formats

xml, json, jsonp

HTTP Method

GET

Requires Authentication

False

Parameters

  • id (Required): The id of the place
  • user (Optional): Restrict to photos taken by this user only. Must be username, not user ID.

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<place>
	    <id>4ecd9d209af189a2</id>
	    <name>Wendy's</name>
	    <country_code>US</country_code>
	    <bounding_box>[[[-76.323033,40.052706],[-76.323033,40.052706],[-76.323033,40.052706],[-76.323033,40.052706]]]</bounding_box>
	    <geometry>[-76.323033,40.052706]</geometry>
	    <geometry_type>Point</geometry_type>
	    <type>poi</type>
	    <attributes>
	        <postal_code>17603</postal_code>
	        <street_address>1117 Harrisburg Ave</street_address>
	        <phone>(717) 393-1065</phone>
	    </attributes>
	    <contained_within>Lancaster, PA</contained_within>
	    <user />
	    <images>
	        <image>
	            <id>89</id>
	            <short_id>2h</short_id>
	            <user_id>1</user_id>
	            <source>site</source>
	            <message>test</message>
	            <views>0</views>
	            <width>960</width>
	            <height>1280</height>
	            <size>413438</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>Wendy's</location>
	            <timestamp>2010-06-24 12:17:47</timestamp>
	            <faces />
	            <user>
	                <id>1</id>
	                <twitter_id>12345</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/1277334364/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/1277334364/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>
	            <comments />
	    		<events>
        		    <id>1</id>
        		    <user_id>1</user_id>
        		    <name>PARTAY</name>
        		    <description>WOO</description>
        		    <timestamp>2010-06-09 17:34:10</timestamp>
        		</events>
	            <application />
	        </image>
	    </images>
	</place>	

Sample JSON Response

	
	{
	   "id":"4ecd9d209af189a2",
	   "name":"Wendy's",
	   "country_code":"US",
	   "bounding_box":"[[[-76.323033,40.052706],[-76.323033,40.052706],[-76.323033,40.052706],[-76.323033,40.052706]]]",
	   "geometry":"[-76.323033,40.052706]",
	   "geometry_type":"Point",
	   "type":"poi",
	   "attributes":{
	      "postal_code":"17603",
	      "street_address":"1117 Harrisburg Ave",
	      "phone":"(717) 393-1065"
	   },
	   "contained_within":"Lancaster, PA",
	   "user":null,
	   "images":[
	      {
	         "id":"122594279",
	         "short_id":"20zmcn",
	         "user_id":"5081301",
	         "source":"site",
	         "message":"test",
	         "views":"0",
	         "width":"960",
	         "height":"1280",
	         "size":"413438",
	         "type":"jpg",
	         "status_id":"17339831561",
	         "in_reply_to_status_id":"0",
	         "in_reply_to_user_id":"0",
	         "location":"Wendy's",
	         "timestamp":"2010-06-29 14:33:38",
	         "user":{
	            "id":"5081301",
	            "twitter_id":"16984249",
	            "username":"twitpicdev",
	            "name":"twitpicdev",
	            "location":"The Interwebs",
	            "website":"http:\/\/twitpic.com",
	            "bio":"Hi :)",
	            "avatar_url":"http:\/\/s.twimg.com\/a\/1278630136\/images\/default_profile_2_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\/1278630136\/images\/themes\/theme1\/bg.png",
	            "profile_background_tile":"0",
	            "utc_offset":"-21600",
	            "geo_enabled":"1",
	            "public_updates":"1",
	            "public_tagging":"0",
	            "banned":"0",
	            "timestamp":"2009-10-30 17:43:17",
	            "events":null,
	            "images":null,
	            "places":null
	         },
	         "faces":null,
	         "comments":null,
	         "events":null,
	         "application":null
	      }
	   ]
	}	

Example CURL Command

	curl -v "http://api.twitpic.com/2/place/show.json?id=4ecd9d209af189a2"