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 […]</description>
    <highlighted-date type="datetime" nil="true"></highlighted-date>
    <id type="integer">2645</id>
    <keywords>madrid, spain, eating-drinking, abundant portions  […]</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/[…]</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é […]</description>
    <highlighted-date type="datetime" nil="true"></highlighted-date>
    <id type="integer">1899</id>
    <keywords>madrid, spain, eating-drinking, cafetería at doré  […]</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/[…]</long_guid>
  </item>
</items>

Error codes:

• 401: API Key not valid
• 404: Place not found

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 […]</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/[…]</long_guid>
</item>
        

Error codes:

• 401: API Key not valid
• 404: Item not found

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/[…].jpg</url>
  </picture>
  <picture>
    <content_type>image/jpg</content_type>
    <width>500</width>
    <height>375</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpg</url>
  </picture>
  <picture>
    <content_type>image/jpg</content_type>
    <width>800</width>
    <height>533</height>
    lt;url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpg</url>
  </picture>
  <picture>
    <content_type>image/jpeg</content_type>
    <width>640</width>
    <height>480</height>
    <url>http://a3.iwannagothere.com/userfiles/pictures/[…].jpeg</url>
  </picture>
</pictures>
        

Error codes:

• 401: API Key not valid
• 404: Item not found

Back to API overview