API Documentation

Feeling RESTful?

API v2 » places/show (GET)

Description

This method returns every place where a user has taken photos BETA

URL

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

Available Formats

xml, json, jsonp

HTTP Method

GET

Requires Authentication

False

Parameters

  • user (Required): The username of the user

Responses

Sample XML Response

	
	<?xml version="1.0" encoding="UTF-8"?>
	<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>
	        <place>
	            <id>149a45b8ab644614</id>
	            <name>Cincinnati Wholesale Supply (Fairfld Oh)</name>
	            <country_code>US</country_code>
	            <bounding_box>[[[-84.485459,39.331414],[-84.485459,39.331414],[-84.485459,39.331414],[-84.485459,39.331414]]]</bounding_box>
	            <geometry>[-84.485459,39.331414]</geometry>
	            <geometry_type>Point</geometry_type>
	            <type>poi</type>
	            <attributes>
	                <postal_code>45014</postal_code>
	                <street_address>4125 Port Union Rd</street_address>
	                <phone>(513) 881-4580</phone>
	            </attributes>
	            <contained_within>Fairfield, OH</contained_within>
	            <user />
	            <images />
	        </place>
	        <place>
	            <id>3451ec05d42e99ef</id>
	            <name>Turkey Hill Minit Market (Store No 79)</name>
	            <country_code>US</country_code>
	            <bounding_box>[[[-76.321698,40.051689],[-76.321698,40.051689],[-76.321698,40.051689],[-76.321698,40.051689]]]</bounding_box>
	            <geometry>[-76.321698,40.051689]</geometry>
	            <geometry_type>Point</geometry_type>
	            <type>poi</type>
	            <attributes>
	                <postal_code>17603</postal_code>
	                <street_address>1004 Harrisburg Ave</street_address>
	                <phone>(717) 393-6561</phone>
	            </attributes>
	            <contained_within>Lancaster, PA</contained_within>
	            <user />
	            <images />
	        </place>
	        <place>
	            <id>3a3c5865cf2b7a86</id>
	            <name>Walnut St Grille At The Brewery</name>
	            <country_code>US</country_code>
	            <bounding_box>[[[-76.298177,40.04367],[-76.298177,40.04367],[-76.298177,40.04367],[-76.298177,40.04367]]]</bounding_box>
	            <geometry>[-76.298177,40.04367]</geometry>
	            <geometry_type>Point</geometry_type>
	            <type>poi</type>
	            <attributes>
	                <postal_code>17602</postal_code>
	                <street_address>302 N Plum St</street_address>
	                <phone>(717) 391-6258</phone>
	            </attributes>
	            <contained_within>Lancaster, PA</contained_within>
	            <user />
	            <images />
	        </place>
	        <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 />
	        </place>
	        <place>
	            <id>83a44c0f87d019ef</id>
	            <name>Bube's Brewery (Mt Joy)</name>
	            <country_code>US</country_code>
	            <bounding_box>[[[-76.502978,40.111759],[-76.502978,40.111759],[-76.502978,40.111759],[-76.502978,40.111759]]]</bounding_box>
	            <geometry>[-76.502978,40.111759]</geometry>
	            <geometry_type>Point</geometry_type>
	            <type>poi</type>
	            <attributes>
	                <postal_code>17552</postal_code>
	                <street_address>102 N Market St</street_address>
	                <phone>(717) 653-2056</phone>
	            </attributes>
	            <contained_within>Mount Joy, PA</contained_within>
	            <user />
	            <images />
	        </place>
	        <place>
	            <id>c6bac3ac01a9442e</id>
	            <name>Iron Hill Brewery &amp; Restaurant</name>
	            <country_code>US</country_code>
	            <bounding_box>[[[-76.318661,40.050548],[-76.318661,40.050548],[-76.318661,40.050548],[-76.318661,40.050548]]]</bounding_box>
	            <geometry>[-76.318661,40.050548]</geometry>
	            <geometry_type>Point</geometry_type>
	            <type>poi</type>
	            <attributes>
	                <postal_code>17603</postal_code>
	                <street_address>781 Harrisburg Ave</street_address>
	                <phone>(717) 291-9800</phone>
	            </attributes>
	            <contained_within>Lancaster, PA</contained_within>
	            <user />
	            <images />
	        </place>
	    </places>
	</user>	

Sample JSON Response

	
	{
	   "id":"5081301",
	   "twitter_id":"16984249",
	   "username":"twitpicuser",
	   "name":"twitpicuser",
	   "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":[
	      {
	         "id":"0d99a8f7c66b85e4",
	         "name":"Lancaster Arts Hotel",
	         "country_code":"US",
	         "bounding_box":"[[[-76.312348,40.046975],[-76.312348,40.046975],[-76.312348,40.046975],[-76.312348,40.046975]]]",
	         "geometry":"[-76.312348,40.046975]",
	         "geometry_type":"Point",
	         "type":"poi",
	         "attributes":{
	            "postal_code":"17603",
	            "street_address":"300 Harrisburg Ave",
	            "phone":"(717) 299-3000"
	         },
	         "contained_within":"Lancaster, PA",
	         "user":null,
	         "images":null
	      },
	      {
	         "id":"28db2dbc4240f0b2",
	         "name":"Worcester",
	         "country_code":"US",
	         "bounding_box":"[[[-71.883917,42.209691],[-71.731559,42.209691],[-71.731559,42.341179],[-71.883917,42.341179]]]",
	         "geometry":"[[[-71.740942,42.234477],[-71.796832,42.209691],[-71.806757,42.223842],[-71.809668,42.230955],[-71.856543,42.226648],[-71.883917,42.281392],[-71.786114,42.341179],[-71.758342,42.296061],[-71.751782,42.256174],[-71.748963,42.248844],[-71.747076,42.248679],[-71.748437,42.24797],[-71.746407,42.244134],[-71.739894,42.242728],[-71.739477,42.243848],[-71.731559,42.24131],[-71.73424,42.236858],[-71.740942,42.234477]]]",
	         "geometry_type":"Polygon",
	         "type":"city",
	         "attributes":{
	
	         },
	         "contained_within":"Massachusetts, US",
	         "user":null,
	         "images":null
	      },
	      {
	         "id":"3451ec05d42e99ef",
	         "name":"Turkey Hill Minit Market (Store No 79)",
	         "country_code":"US",
	         "bounding_box":"[[[-76.321698,40.051689],[-76.321698,40.051689],[-76.321698,40.051689],[-76.321698,40.051689]]]",
	         "geometry":"[-76.321698,40.051689]",
	         "geometry_type":"Point",
	         "type":"poi",
	         "attributes":{
	            "postal_code":"17603",
	            "street_address":"1004 Harrisburg Ave",
	            "phone":"(717) 393-6561"
	         },
	         "contained_within":"Lancaster, PA",
	         "user":null,
	         "images":null
	      },
	      {
	         "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":null
	      }
	   ]
	}	

Example CURL Command

	curl -v "http://api.twitpic.com/2/places/show.json?user=twitpicuser"