api_full - TrustedPlaces - Local Reviews of Restaurants, Pubs, Bars, Clubs & More

TrustedPlaces API Documentation

Requirements

You need to obtain a key to use the TrustedPlaces API. To obtain a key, you first need to register onto TrustedPlaces. Once you've registered open this page: http://trustedplaces.com/api/getkey , accept the Terms & Conditions and a key will be sent to you by email.

Methods

All methods require parameter key that should contain valid API key.
Example of method invoke: latest reviews for Namco Station
Parameters can be passed either in GET or POST mode.

Places

Required parameter for all places methods: place that should contain unique place ID, it can be obtained from place URL, for example Namco Station's URL is http://trustedplaces.com/review/uk/london/bar/1n92y7l/namco-station thus it's place ID is "1n92y7l"

Place info

Overview: Get place's basic info
Address http://trustedplaces.com/api/rest/place/

Example http://trustedplaces.com/api/rest/place?place=1p9276v&key=PlaceYourKeyHere

<place>
  <id>1p9276v</id>
  <name>Troubadour Cafe</name>
  <country>United Kingdom</country>

  <city>London</city>
  <district>West Brompton</district>

  <address>263-267 Old Brompton Road</address>
  <longitude>-0.19237192788799</longitude>

  <latitude>51.487855634658</latitude>
  <postcode>SW5 9JA</postcode>
  <category>Restaurants</category>
  <subcategory>Restaurant &amp; Bar</subcategory>

  <description> text </description>
  <phone>020 7370 1434</phone>
  <website>http://www.troubadour.co.uk</website>
  <url>http://trustedplaces.com/review/uk/london/restaurant/1p9276v/troubadour-cafe</url>

  <image>
    <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c60x60.jpg</thumb>
    <small>http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c110x110.jpg</small>
    <big>http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c640x480.jpg</big>

  </image>
  <added>2007-06-17T22:34:58+00:00</added>
  <rating>4.1</rating>
  <total_reviews>10</total_reviews>

  <tags>
    <tag>live music</tag>
    <tag>american</tag>
    <tag>relaxed</tag>

  </tags>
</place>

Reviews

Overview: Get 15 latest place reviews.
Address http://trustedplaces.com/api/rest/place/reviews
To get the total number of reviews http://trustedplaces.com/api/rest/place/reviews/total

Example http://trustedplaces.com/api/rest/place/reviews?place=1p9276v&key=PlaceYourKeyHere

<reviews>
 <review>
  <title> text </title>
  <body> text </body>

  <author>SlipJ</author>
  <rating>5</rating>
  <total_comments>0</total_comments>
  <added>2007-10-03T13:40:52+00:00</added>

   <image>http://cdn.trustedplaces.com/i/uploads/userpics/MichalD_ad2142d0.c80x80.jpg</image>
 </review>
</reviews>

Images

Overview: Get 15 latest place pictures.
Address http://trustedplaces.com/api/rest/place/images
To get the total number of images http://trustedplaces.com/api/rest/place/images/total

Example http://trustedplaces.com/api/rest/place/images?place=1p9276v&key=PlaceYourKeyHere

<placeimages>
 <image>
  <thumb> http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c60x60.jpg </thumb>
  <small> http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c110x110.jpg </small>

  <big> http://cdn.trustedplaces.com/i/uploads/placepics/1h35z8_6598d06e.c640x480.jpg </big>
 </image>
</placeimages>

Lists - Favourites

Overview: Get a list of all users who have added this place to their favourites lists.
Address http://trustedplaces.com/api/rest/place/lists/favourites
To get the total number of users http://trustedplaces.com/api/rest/place/lists/favourites/total

Example http://trustedplaces.com/api/rest/place/lists/favourites?place=1p9276v&key=PlaceYourKeyHere

<users>
 <user>
  <name>caffeinehit</name>

  <online>2007-10-03T13:40:52+00:00</online>
  <total_reviews>18</total_reviews>
  <image>http://cdn.trustedplaces.com/i/uploads/userpics/caffeinehit_9fdc630a.60.jpg</image>
 </user>

</users>

Lists - Want to go

Overview: Get a list of all users who have added this place to their want-to-go lists.
Address http://trustedplaces.com/api/rest/place/lists/wantgo
To get the total number of users http://trustedplaces.com/api/rest/place/lists/wantgo/total

Example http://trustedplaces.com/api/rest/place/lists/wantgo?place=1p9276v&key=PlaceYourKeyHere

<users>

 <user>
  <name>marys</name>
  <online>2007-07-31T12:22:49+00:00</online>
  <total_reviews>1</total_reviews>

  <image>http://cdn.trustedplaces.com/i/uploads/userpics/marys_101bb20f.60.jpg</image>
 </user>
</users>

Geo locations

Overview: Get list of places from a defined location
Parameters:
- Required: country, city
- Optional: district, category, subcategory
Address http://trustedplaces.com/api/rest/place/geo
To get the total number of places http://trustedplaces.com/api/rest/place/geo/total

Example getting indian restaurants in Westminster, London, UK

<places>

  <place>
    <id>1113081</id>
    <name>Benares</name>
    <country>United Kingdom</country>

    <city>London</city>
    <district>Bond Street</district>
    <address>12 Berkeley Square</address>
    <postcode>W1J 6AN</postcode>

    <longitude>-0.14539551192232</longitude>
    <latitude>51.509603753059</latitude>
    <category>Restaurants</category>
    <subcategory></subcategory>

    <description></description>
    <phone>020 7629 8886</phone>
    <website></website>
    <url>http://trustedplaces.com/review/uk/london/restaurant/1113081/benares</url>

    <image>
      <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1212d7b_4efe2145.c60x60.jpg</thumb>
      <small>http://cdn.trustedplaces.com/i/uploads/placepics/1212d7b_4efe2145.c110x110.jpg</small>
      <big>http://cdn.trustedplaces.com/i/uploads/placepics/1212d7b_4efe2145.c640x480.jpg</big>

    </image>
    <added>2007-06-18T00:15:44+00:00</added>
    <rating>4</rating>
    <total_reviews>1</total_reviews>

    <tags>
      <tag>pricey</tag>
      <tag>indian</tag>
      <tag>restaurant</tag>

    </tags>
  </place>
</places>

Geo locations longitude, latitude and radius

Overview: Get list of places within a certain radius around a latitude and longitude point
Parameters
- Required: longitude, latitude, radius
- Optional: from, to, sort
Address http://trustedplaces.com/api/rest/place/geo
To get the total number of places http://trustedplaces.com/api/rest/place/geo/total

Example http://trustedplaces.com/api/rest/place/geo/?lng=-0.126236&lat=51.500152&rad=500&key=PlaceYourKeyHere

<places>
  <place>
    <id>1n42x8p</id>
    <name>10 Downing Street</name>
    <country>United Kingdom</country>

    <city>London</city>
    <district>Westminster</district>
    <address>10 Downing Street</address>
    <postcode>SW1A 2AA</postcode>

    <longitude>-0.1283711741283</longitude>
    <latitude>51.503038373461</latitude>
    <category></category>
    <subcategory></subcategory>

    <description></description>
    <phone></phone>
    <website>http://www.number-10.gov.uk</website>
    <url>http://trustedplaces.com/review/uk/london/cultural/1n42x8p/10-downing-street</url>

    <image></image>
    <added>2006-09-26T08:08:00+00:00</added>
    <rating>1</rating>
    <total_reviews>1</total_reviews>

    <tags/>
  </place>
</places>

Place search

Overview: Search places by name and location
Parameters
- Required: what
- Optional: where, from, to, sort
Address http://trustedplaces.com/api/rest/place/search
To get the total number of places http://trustedplaces.com/api/rest/place/search/total

Example http://trustedplaces.com/api/rest/place/search/?what=parker&where=london&key=PlaceYourKeyHere

<places>
  <place>
    <id>1n42z78</id>

    <name>Parker McMillan</name>
    <country>United Kingdom</country>
    <city>London</city>
    <district>Bishopsgate</district>

    <address>47 Chiswell Street</address>
    <postcode>EC1Y 4SB</postcode>
    <longitude>-0.093061900055801</longitude>
    <latitude>51.520454975201</latitude>

    <category></category>
    <subcategory></subcategory>
    <description></description>
    <phone></phone>
    <website></website>

    <url>http://trustedplaces.com/review/uk/london/bar-pub/1n42z78/parker-mcmillan</url>
    <image>
      <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/124388_0b2b1656.c60x60.jpg</thumb>
      <small>http://cdn.trustedplaces.com/i/uploads/placepics/124388_0b2b1656.c110x110.jpg</small>

      <big>http://cdn.trustedplaces.com/i/uploads/placepics/124388_0b2b1656.c640x480.jpg</big>
    </image>
    <added>2007-09-11T19:55:20+00:00</added>
    <rating>4.3846153846154</rating>

    <total_reviews>18</total_reviews>
    <tags/>
  </place>
</places>

Users

Required parameter for all user methods: user needs to hold a valid username.

Basic info

Overview: Get basic info for user
Address http://trustedplaces.com/api/rest/user

Example http://trustedplaces.com/api/rest/user?user=walid&key=PlaceYourKeyHere

<user>
  <name>walid</name>

  <country>United Kingdom</country>
  <city>London</city>
  <birthyear>1974</birthyear>
  <about>text</about>

  <total_reviews>107</total_reviews>
  <total_friends>319</total_friends>
  <url>http://trustedplaces.com/user/walid</url>
  <image>

    <thumb>http://cdn.trustedplaces.com/i/uploads/userpics/walid_3747ba39.c60x60.jpg</thumb>
    <small>http://cdn.trustedplaces.com/i/uploads/userpics/walid_3747ba39.c110x110.jpg</small>
    <big>http://cdn.trustedplaces.com/i/uploads/userpics/walid_3747ba39.c640x480.jpg</big>
  </image>

</user>

Reviews

Overview: Get 15 latest user reviews.
Address http://trustedplaces.com/api/rest/user/reviews
To get the total number of reviews http://trustedplaces.com/api/rest/user/reviews/total

Example http://trustedplaces.com/api/rest/user/reviews?user=walid&key=PlaceYourKeyHere

<reviews>
  <review>
    <place>
      <id>1b22z9</id>
      <name>202 Cafe (NF Restaurants Ltd)</name>

      <country>United Kingdom</country>
      <city>London</city>
      <district>Notting Hill</district>
      <address>202-204 Westbourne Grove Colville</address>

      <longitude>-0.20142284204719</longitude>
      <latitude>51.514073482637</latitude>
      <postcode>W11 2RH</postcode>
      <category>Cafes</category>

      <subcategory></subcategory>
      <phone>020 7792 6888</phone>
      <website></website>
      <url>http://trustedplaces.com/review/uk/london/cafe/1b22z9/202-cafe-(nf-restaurants-ltd)/1j2098</url>

      <rating>4.6</rating>
      <total_reviews>5</total_reviews>
      <tags>
        <tag>expensive</tag>

        <tag>lazy sunday</tag>
        <tag>french toast</tag>
        <tag>pancakes</tag>
        <tag>good brew</tag>

        <tag>professional staff</tag>
        <tag>crowded</tag>
        <tag>brunch</tag>
        <tag>coffee</tag>

        <tag>cafe</tag>
        <tag>friendly staff</tag>
      </tags>
      <image>
        <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c60x60.jpg</thumb>

        <small>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c110x110.jpg</small>
        <big>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c640x480.jpg</big>
      </image>
    </place>
    <title>Brunch Perfection</title>

    <review>text</review>
    <author>walid</author>
    <rating>5</rating>
    <added>2006-11-02T10:49:15+00:00</added>

  </review>
</reviews>

Friends

Overview: Get 15 latest user friends.
Address http://trustedplaces.com/api/rest/user/friends
To get the total number of friends http://trustedplaces.com/api/rest/user/friends/total

Example http://trustedplaces.com/api/rest/user/friends?user=walid&key=PlaceYourKeyHere

<users>
  <user>
    <name>Adisa75</name>
    <online>2006-11-08T14:58:28+00:00</online>
    <total_reviews>5</total_reviews>

    <image>
      <thumb>http://cdn.trustedplaces.com/i/uploads/userpics/Adisa75_ae86e1a3.c60x60.jpg</thumb>

      <small>http://cdn.trustedplaces.com/i/uploads/userpics/Adisa75_ae86e1a3.c110x110.jpg</small>
      <big>http://cdn.trustedplaces.com/i/uploads/userpics/Adisa75_ae86e1a3.c640x480.jpg</big>

    </image>
  </user>
</users>

Images

Overview: Get 15 latest user pictures.
Address http://trustedplaces.com/api/rest/user/images
To get the total number of images http://trustedplaces.com/api/rest/user/images/total

Example http://trustedplaces.com/api/rest/user/images?user=walid&key=PlaceYourKeyHere

<userimages>
 <image>
  <thumb>http://cdn.trustedplaces.com/i/uploads/userpics/walid_87c71eea.c60x60.jpg</thumb>
  <small>http://cdn.trustedplaces.com/i/uploads/userpics/walid_87c71eea.c110x110.jpg</small>

  <big>http://cdn.trustedplaces.com/i/uploads/userpics/walid_87c71eea.c640x480.jpg</big>
 </image>
</userimages>

Lists - Favourites

Overview: Get 15 latest user favourite places.
Address http://trustedplaces.com/api/rest/user/lists/favourites
To get the total number of places in list http://trustedplaces.com/api/rest/user/lists/favourites/total

Example http://trustedplaces.com/api/rest/user/lists/favourites?user=walid&key=PlaceYourKeyHere

<places>
  <place>
    <id>1b22z9</id>
    <name>202 Cafe (NF Restaurants Ltd)</name>

    <country>United Kingdom</country>
    <city>London</city>
    <district>Notting Hill</district>
    <address>202-204 Westbourne Grove Colville</address>

    <postcode>W11 2RH</postcode>
    <longitude>-0.20142284204719</longitude>
    <latitude>51.514073482637</latitude>
    <category>Cafes</category>

    <subcategory></subcategory>
    <description>202 serves beers, wines and spirits as well as a selection of dishes including brunch and light snacks.</description>
    <phone>020 7792 6888</phone>
    <website></website>

    <url>http://trustedplaces.com/review/uk/london/cafe/1b22z9/202-cafe-(nf-restaurants-ltd)</url>
    <image>
      <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c60x60.jpg</thumb>
      <small>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c110x110.jpg</small>

      <big>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c640x480.jpg</big>
    </image>
    <added>2006-11-02T10:40:20+00:00</added>
    <rating>4.6</rating>

    <total_reviews>5</total_reviews>
    <tags>
      <tag>friendly staff</tag>
      <tag>brunch</tag>

      <tag>expensive</tag>
      <tag>brasserie</tag>
    </tags>
  </place>
</places>

Lists - Want to go

Overview: Get 15 latest user want-to-go places.
Address http://trustedplaces.com/api/rest/user/lists/wantgo
To get the total number of places in list http://trustedplaces.com/api/rest/user/lists/wantgo/total

Example http://trustedplaces.com/api/rest/user/lists/wantgo?user=walid&key=PlaceYourKeyHere

<places>
  <place>

    <id>1b22z9</id>
    <name>202 Cafe (NF Restaurants Ltd)</name>
    <country>United Kingdom</country>
    <city>London</city>

    <district>Notting Hill</district>
    <address>202-204 Westbourne Grove Colville</address>
    <postcode>W11 2RH</postcode>
    <longitude>-0.20142284204719</longitude>

    <latitude>51.514073482637</latitude>
    <category>Cafes</category>
    <subcategory></subcategory>
    <description>202 serves beers, wines and spirits as well as a selection of dishes including brunch and light snacks.</description>

    <phone>020 7792 6888</phone>
    <website></website>
    <url>http://trustedplaces.com/review/uk/london/cafe/1b22z9/202-cafe-(nf-restaurants-ltd)</url>
    <image>

      <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c60x60.jpg</thumb>
      <small>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c110x110.jpg</small>
      <big>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c640x480.jpg</big>
    </image>

    <added>2006-11-02T10:40:20+00:00</added>
    <rating>4.6</rating>
    <total_reviews>5</total_reviews>
    <tags>

      <tag>friendly staff</tag>
      <tag>brunch</tag>
      <tag>expensive</tag>
      <tag>brasserie</tag>

    </tags>
  </place>
</places>

Lists - Favourites + Want to go

Overview: Get 15 latest user favourites AND want-to-go places.
Address http://trustedplaces.com/api/rest/user/lists/favourites+wantgo
To get the total number of places in list http://trustedplaces.com/api/rest/user/lists/favourites+wantgo/total

Example http://trustedplaces.com/api/rest/user/lists/favourites+wantgo?user=walid&key=PlaceYourKeyHere

<places>
  <place>
    <id>1b22z9</id>
    <name>202 Cafe (NF Restaurants Ltd)</name>

    <country>United Kingdom</country>
    <city>London</city>
    <district>Notting Hill</district>
    <address>202-204 Westbourne Grove Colville</address>

    <postcode>W11 2RH</postcode>
    <longitude>-0.20142284204719</longitude>
    <latitude>51.514073482637</latitude>
    <category>Cafes</category>

    <subcategory></subcategory>
    <description>202 serves beers, wines and spirits as well as a selection of dishes including brunch and light snacks.</description>
    <phone>020 7792 6888</phone>
    <website></website>

    <url>http://trustedplaces.com/review/uk/london/cafe/1b22z9/202-cafe-(nf-restaurants-ltd)</url>
    <image>
      <thumb>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c60x60.jpg</thumb>
      <small>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c110x110.jpg</small>

      <big>http://cdn.trustedplaces.com/i/uploads/placepics/1b22z9_b5e84f10.c640x480.jpg</big>
    </image>
    <added>2006-11-02T10:40:20+00:00</added>
    <rating>4.6</rating>

    <total_reviews>5</total_reviews>
    <tags>
      <tag>friendly staff</tag>
      <tag>brunch</tag>

      <tag>expensive</tag>
      <tag>brasserie</tag>
    </tags>
  </place>
</places>

Friends - Reviews

Overview: Get 15 latest reviews done by user friends.
Address http://trustedplaces.com/api/rest/user/friends/reviews
To get the total number of reviews in list http://trustedplaces.com/api/rest/user/friends/reviews/total

Example http://trustedplaces.com/api/rest/user/friends/reviews?user=walid&key=PlaceYourKeyHere

<reviews>
  <review>

    <place>
      <id>1c0488t</id>
      <name>Sue Crows Nest</name>
      <country>Australia</country>

      <city>Sydney</city>
      <district></district>
      <address>100 Willoughby Road</address>
      <longitude>151.200709</longitude>

      <latitude>-33.824809</latitude>
      <postcode>2065</postcode>
      <category></category>
      <subcategory></subcategory>

      <phone>9948 5844</phone>
      <website>www.suecn.com.au</website>
      <url>http://trustedplaces.com/review/australia/sydney/unknown/1c0488t/sue-crows-nest/1c14a8</url>
      <rating>3</rating>

      <total_reviews>1</total_reviews>
      <tags/>
      <image></image>
    </place>
    <title>Cafe</title>

    <review>Friendly cafe</review>
    <author>sue</author>
    <rating>3</rating>
    <added>2007-11-09T11:21:18+00:00</added>

  </review>
</reviews>

Side notes

Some methods can accept from, to and sort options. We'll detail those later on.

TrustedPlaces

TrustedPlaces API Documentation

Table of Contents

Requirements

Methods

Places

Place info

Reviews

Images

Lists - Favourites

Lists - Want to go

Geo locations

Geo locations longitude, latitude and radius

Place search

Users

Basic info

Reviews

Friends

Images

Lists - Favourites

Lists - Want to go

Lists - Favourites + Want to go

Friends - Reviews

Side notes

Restaurants

Bars & Pubs

Hotels & Travel

Nightlife

Food & Drink

Take Aways

Shopping

more

API Documentation

TrustedPlaces API Documentation

Table of Contents

Requirements

Methods

Places

Place info

Reviews

Images

Lists - Favourites

Lists - Want to go

Geo locations

Geo locations longitude, latitude and radius

Place search

Users

Basic info

Reviews

Friends

Images

Lists - Favourites

Lists - Want to go

Lists - Favourites + Want to go

Friends - Reviews

Side notes

more

In London, UK

API Documentation