/location-restaurants

 

Call the API with the unique ID for a destination.  The response will provide a maximum list of top 10 restaurants along with data for each restaurant in the list. Alternatively, call the API with a comma-separated list of restaurant location ids, get data for the restaurants in your list.

Request

http://api.tripadvisor.com/api/partner/2.0/location/187147/restaurants?key=PARTNER_KEY

Query Parameters

Name Description
lang The desired language locale. 
currency currency code to use for request and response (should follow ISO 4217).
subcategory

Filters results list of restaurants by subcategory. Input a comma separated list of subcategories to inlcude. Valid subcategories are: bakery, fast_food, sit_down.

Note: bakery has since been merged with cafe, and deli has been merged with fast food so the results for those will be identical.
cuisines Filters results list of restaurants by cuisine. Input a comma separated list of cuisines to inlcude. Note that one restaurant may have multiple cuisines. Valid cuisines are: Please note that the '%2F' is a url-encoded '/'. 'African' 'American' 'Asian' 'Barbecue' 'British' 'Cafe' 'Cajun & Creole' 'Caribbean' 'Chinese' 'Delicatessen' 'Eastern European' 'Fusion%2FEclectic' 'European' 'French' 'German' 'Global%2FInternational' 'Greek' 'Indian' 'Irish' 'Italian' 'Japanese' 'Mediterranean' 'Mexican%2FSouthwestern' 'Middle Eastern' 'Pizza' 'Pub' 'Seafood' 'Soups' 'South American' 'Spanish' 'Steakhouse' 'Sushi' 'Thai' 'Vietnamese'
prices Filters results list of restaurants by price. Input a comma separated list of prices to include. This can include numbers between 1 and 4, inclusive, which rank from least expensive to most expensive.

Response

{
  "data": [
    {
      "address_obj": {
        "street1": "10 Avenue d Iena",
        "street2": "Shangri-La Hotel, Paris - Lobby Level",
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75116",
        "address_string": "10 Avenue d Iena Shangri-La Hotel, Paris - Lobby Level, 75116 Paris France"
      },
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [
              {
                "open_time": "07:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "07:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "07:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "07:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [
              {
                "open_time": "07:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": 89,
      "latitude": "48.863438",
      "rating": "4.5",
      "cuisine": [
        {
          "name": "french",
          "localized_name": "French"
        },
        {
          "name": "european",
          "localized_name": "European"
        }
      ],
      "location_id": "2279500",
      "restaurant_booking": {
        "bookable": true,
        "booking_url": "http://thefork.com/restaurant/na/8976?cc=19349-dc6"
      },
      "ranking_data": {
        "ranking_string": "#1 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "1",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#1 of 14,172 Restaurants in Paris"
        ]
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/2279500?key=PARTNER_KEY",
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2279500-Reviews-mMCID-L_Abeille-Paris_Ile_de_France.html",
      "price_level": "$$$$",
      "rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-MCID-5.svg",
      "awards": [
        {
          "award_type": "Certificate of Excellence",
          "year": "2016",
          "images": {
            "small": "http://www.tripadvisor.com/img/cdsi/img2/awards/CERTIFICATE_OF_EXCELLENCE_small-MCID-5.jpg",
            "large": "http://www.tripadvisor.com/img/cdsi/img2/awards/CERTIFICATE_OF_EXCELLENCE_2016_en_US_large-MCID-5.jpg"
          },
          "categories": [],
          "display_name": "Certificate of Excellence 2016"
        }
      ],
      "name": "L'Abeille",
      "num_reviews": "304",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d2279500-mMCID-L_Abeille-Paris_Ile_de_France.html",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "ancestors": [
        {
          "abbrv": null,
          "level": "City",
          "name": "Paris",
          "location_id": "187147"
        },
        {
          "abbrv": null,
          "level": "Region",
          "name": "Ile-de-France",
          "location_id": "187144"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "France",
          "location_id": "187070"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2279500-mMCID-Reviews-L_Abeille-Paris_Ile_de_France.html#photos",
      "longitude": "2.293583"
    },
    {
      "address_obj": {
        "street1": "2 rue Germain Pilon",
        "street2": null,
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75018",
        "address_string": "2 rue Germain Pilon, 75018 Paris France"
      },
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": null,
      "latitude": "48.88309",
      "rating": "5.0",
      "cuisine": [
        {
          "name": "french",
          "localized_name": "French"
        },
        {
          "name": "brew_pub",
          "localized_name": "Brew Pub"
        },
        {
          "name": "european",
          "localized_name": "European"
        }
      ],
      "location_id": "10514254",
      "restaurant_booking": {
        "bookable": false,
        "booking_url": null
      },
      "ranking_data": {
        "ranking_string": "#2 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "2",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#2 of 14,172 Restaurants in Paris"
        ]
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/10514254?key=PARTNER_KEY",
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d10514254-Reviews-mMCID-Les_Apotres_de_Pigalle-Paris_Ile_de_France.html",
      "price_level": "$$ - $$$",
      "rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/5.0-MCID-5.svg",
      "awards": [],
      "name": "Les Apotres de Pigalle",
      "num_reviews": "633",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d10514254-mMCID-Les_Apotres_de_Pigalle-Paris_Ile_de_France.html",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "ancestors": [
        {
          "abbrv": null,
          "level": "City",
          "name": "Paris",
          "location_id": "187147"
        },
        {
          "abbrv": null,
          "level": "Region",
          "name": "Ile-de-France",
          "location_id": "187144"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "France",
          "location_id": "187070"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d10514254-mMCID-Reviews-Les_Apotres_de_Pigalle-Paris_Ile_de_France.html#photos",
      "longitude": "2.336348"
    },
    {
      "address_obj": {
        "street1": "5 rue de Poissy",
        "street2": null,
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75005",
        "address_string": "5 rue de Poissy, 75005 Paris France"
      },
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "14:00"
              },
              {
                "open_time": "19:30",
                "close_time": "22:00"
              }
            ],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "14:00"
              },
              {
                "open_time": "19:30",
                "close_time": "22:00"
              }
            ],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "14:00"
              },
              {
                "open_time": "19:30",
                "close_time": "22:00"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "14:00"
              },
              {
                "open_time": "19:30",
                "close_time": "22:00"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "14:00"
              },
              {
                "open_time": "19:30",
                "close_time": "22:00"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": null,
      "latitude": "48.85006",
      "rating": "5.0",
      "cuisine": [
        {
          "name": "french",
          "localized_name": "French"
        }
      ],
      "location_id": "9467731",
      "restaurant_booking": {
        "bookable": false,
        "booking_url": null
      },
      "ranking_data": {
        "ranking_string": "#3 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "3",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#3 of 14,172 Restaurants in Paris"
        ]
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/9467731?key=PARTNER_KEY",
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d9467731-Reviews-mMCID-Alliance-Paris_Ile_de_France.html",
      "price_level": "$$$$",
      "rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/5.0-MCID-5.svg",
      "awards": [],
      "name": "Alliance",
      "num_reviews": "174",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d9467731-mMCID-Alliance-Paris_Ile_de_France.html",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "ancestors": [
        {
          "abbrv": null,
          "level": "City",
          "name": "Paris",
          "location_id": "187147"
        },
        {
          "abbrv": null,
          "level": "Region",
          "name": "Ile-de-France",
          "location_id": "187144"
        },
        {
          "abbrv": null,
          "level": "Country",
          "name": "France",
          "location_id": "187070"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d9467731-mMCID-Reviews-Alliance-Paris_Ile_de_France.html#photos",
      "longitude": "2.353391"
    }
  ],
  "paging": {
    "next": null,
    "previous": null,
    "results": "3",
    "total_results": "3",
    "skipped": "0"
  }
}

Properties

Name Type Description
location_id number Unique Tripadvisor location ID of the destination or POI.
name string Name of the POI as listed on Tripadvisor.
rating number

Overall rating for this POI. Not applicable to geographic locations. Rating levels are defined as follows:


5

Excellent

4

Very good

3

Average

2

Poor

1

Terrible
rating_image_url URL URL to the bubble rating image for this location. As noted in the Display Guidelines, overall Bubble Ratings must be displayed using the Tripadvisor bubble rating image with the owl icon.
num_reviews number Count of total reviews published for this location.
percent_recommended number

Deprecated as of March 2015. Value will display as 'null.' 
write_review URL Link to the review form for this specific POI on Tripadvisor. Link will be localized to the correct domain if language other than English is requested.
description string Description of the POI, if available. Null if not available. For a majority of POIs, a description is only available in English and it is excluded from the response if a different language is requested.
location_string string Destination location for the POI. Most commonly written as city, state or city, province/region. In cases where state/province/region is not relevant, then it would be city, country. This string is localized if a language other than English is requested.
ranking_data object Describes a POI's Popularity Index ranking on Tripadvisor, which compares places of interest (accomodations, restaurants, and attractions) within the same destination based on their popularity. This is measured by the quality, quantity, and recency of their review content on Tripadvisor.
hours object

Provides localized opening hours for Restaurants and Attractions, using ISO 8601 format.
restaurant_booking object

Includes whether a restaurant is bookable on thefork.com (a Tripadvisor company) and a direct booking link.
category object Each POI on Tripadvisor is classified under a "category" and "subcategory", which is included in the API response. Categories and subcategories may also be used to filter the /location method when a destination (geo) location ID is used.
subcategory object Listings that are accommodations/hotels or restaurants are assigned a single subcategory. Attractions may belong to one or more subcategories, and may also be further classified under "types" which are even more specific.
awards object Returns a list of all of the awards for this location, which includes Certificate of Excellence, Travelers' Choice, and Green Leader. For each award, a small and large image will be returned as well.
latitude number The latitude of this location in degrees. Null if unavailable.
longitude number The longitude of this location in degrees. Null if unavailable.
price_level string The relative price level for the POI. Not available for all POIs. This string is localized into select other currency symbols (e.g. ££££ or €€€€) if a language other than English (en_US) is requested or if a specific currency is selected.
cuisine object Description of the cuisine types of the restaurant.  A restaurant may have zero to many cuisines. (This field is only applicable for location type: restaurant.)
web_url URL Link to the POI detail page on Tripadvisor. Link will be localized to the correct domain if a language other than English is requested.
ancestors object Ancestors describe where the POI or destination lives within the Tripadvisor destination or geo hierarchy. From this, you can derive the city where a POI is located, as well as state/province/region and country.
address_obj object Object containing address data for this location.
see_all_photos URL Link to open all traveler photos posted for this POI in a photo viewer on Tripadvisor. Link will be localized to the correct domain if language other than English is requested.
api_detail_url URL Link to the API url that shows details about one individual location in the list.
paging object Information required to browse the next and previous sets of locations in the list, if they were not all returned as part of the current call.