Back to API overview

Items

Get all items from a place

Http request with GET method: 
http://iwannagothere.com/api/places/{geoname_id}/items
Parameters:
  • key: User API key
  • geoname_id: Geoname id of the place
  • limit: Limit number of items. Default to 10
Example response:
<items type="array">
  <item>
    <address>Calle de Caños del Peral, 3, 28013, Madrid, Spain</address>
    <category-id type="integer">3</category-id>
    <coolness type="integer">0</coolness>
    <created-at type="datetime">2009-05-20T08:45:10+02:00</created-at>
    <delta type="boolean">false</delta>
    <description>Great Mexican restaurant where you won't find any typical cheap tex-mex.  The recipes here are Mexican Nouvelle Cuisine, with abundant portions, great ingredients and carefully combined ideas from traditional recipes.  I really enjoyed myself when I went along with a Mexican friend.  Good tequilas too!
    The owners are painters and have beautifully decorated the restaurant.  A great restaurant albeit a bit expensive.</description>
    <highlighted-date type="datetime" nil="true"></highlighted-date>
    <id type="integer">2645</id>
    <keywords>madrid, spain, eating-drinking, entre suspiro y suspiro, abundant portions, nouvelle cuisine, mexican friend, traditional recipes, tequilas, suspiro, tex mex, painters</keywords>
    <lat>40.4185796</lat>
    <long>-3.7089972</long>
    <map-id type="integer">2444</map-id>
    <nicetitle>entre-suspiro-y-suspiro</nicetitle>
    <place-id type="integer">5</place-id>
    <popularity type="float">5.0</popularity>
    <published type="boolean">true</published>
    <reviewed type="boolean">false</reviewed>
    <summercontest09 type="boolean">false</summercontest09>
    <title>Entre Suspiro y Suspiro</title>
    <updated-at type="datetime">2009-07-20T07:07:00+02:00</updated-at>
    <url></url>
    <user-id type="integer">781</user-id>
    <long_guid>http://iwannagothere.com/travel-guides/valencia/highlights/lonja-la-seda</long_guid>
  </item>
  <item>
    <address>Calle de Santa Isabel, 3, 28012, Madrid, Spain</address>
    <category-id type="integer">3</category-id>
    <coolness type="integer">0</coolness>
    <created-at type="datetime">2009-03-11T17:04:12+01:00</created-at>
    <delta type="boolean">false</delta>
    <description>A nice and quite still cafetería at Cine Doré, for enjoying a cup of coffee or eating some chocolatte cake.
    Cine Doré is a really cheap, public cinema, which is responsible for the Spanish Film Library, that shows classic and independent film</description>
    <highlighted-date type="datetime" nil="true"></highlighted-date>
    <id type="integer">1899</id>
    <keywords>madrid, spain, eating-drinking, cafetería at doré cinema, spanish film, film library, cup of coffee, independent film, cinema</keywords>
    <lat>40.4117527</lat>
    <long>-3.6992441</long>
    <map-id type="integer">1776</map-id>
    <nicetitle>cafeteria-at-dore-cinema</nicetitle>
    <place-id type="integer">5</place-id>
    <popularity type="float">5.0</popularity>
    <published type="boolean">true</published>
    <reviewed type="boolean">false</reviewed>
    <summercontest09 type="boolean">false</summercontest09>
    <title>Cafetería at Doré Cinema</title>
    <updated-at type="datetime">2009-07-19T07:00:16+02:00</updated-at>
    <url>http://www.mcu.es/cine/MC/FE/CineDore/Instalaciones.html</url>
    <user-id type="integer">626</user-id>
    <long_guid>http://iwannagothere.com/travel-guides/valencia/highlights/lonja-la-seda</long_guid>
  </item>
</items>
Error codes:
  • 401: API Key not valid
  • 404: Place not found

Get item information from id

Http request with GET method: 
http://iwannagothere.com/api/items/{item_id}
Parameters:
  • key: User API key
  • item_id: Item id
Example response:
<item>
  <address nil="true"></address>
  <category-id type="integer">1</category-id>
  <coolness type="integer" nil="true"></coolness>
  <created-at type="datetime">2009-04-18T10:11:05+02:00</created-at>
  <delta type="boolean">true</delta>
  <description>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</description>
  <highlighted-date type="datetime" nil="true"></highlighted-date>
  <id type="integer">3</id>
  <keywords>madrid, spain, highlights, a nice place 3, </keywords>
  <lat nil="true"></lat>
  <long nil="true"></long>
  <map-id type="integer">32</map-id>
  <nicetitle>a-nice-place-3</nicetitle>
  <place-id type="integer">2</place-id>
  <popularity type="float" nil="true"></popularity>
  <published type="boolean">true</published>
  <reviewed type="boolean">false</reviewed>
  <summercontest09 type="boolean">false</summercontest09>
  <title>A nice place 3</title>
  <updated-at type="datetime">2009-07-13T18:48:33+02:00</updated-at>
  <url>http://example.com</url>
  <user-id type="integer">1</user-id>
  <long_guid>http://iwannagothere.com/travel-guides/valencia/highlights/lonja-la-seda</long_guid>
</item>
Error codes:
  • 401: API Key not valid
  • 404: Item not found

Get photos of a item

Http request with GET method: 
http://iwannagothere.com/api/items/{item_id}/get_photos
Parameters:
  • key: User API key
  • item_id: Item id
  • size: Size of the photos (default 'square')
  • limit: Limit number of photos. Default to 10
Available sizes:
  • thumb: '120x120'
  • square: '75x75'
  • small: '100x100'
  • home: '252x132'
  • square_mini: '48x48'
  • big: '500x500'
Example response:
<pictures>
  <picture>
    <content_type>image/jpg</content_type>
    <width>500</width>
    <height>375</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/0000/0113/original_274636885_2cf6b6d329_square.jpg</url>
  </picture>
  <picture>
    <content_type>image/jpg</content_type>
    <width>500</width>
    <height>375</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/0000/0120/original_mini-P1020861_square.JPG</url>
  </picture>
  <picture>
    <content_type>image/jpg</content_type>
    <width>800</width>
    <height>533</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/0000/0148/original_bernabeu_stadium_estudiolamela200907_4_square.jpg</url>
  </picture>
  <picture>
    <content_type>image/jpeg</content_type>
    <width>640</width>
    <height>480</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/0000/0155/original_pxl_dd256823e338ec287ff8c8e30342a06d_square.jpeg</url>
  </picture>
</pictures>
Error codes:
  • 401: API Key not valid
  • 404: Item not found