/map-restaurants

Same as /map call, restricting results to a maximum of 10 restaurants.

Request

http://api.tripadvisor.com/api/partner/2.0/map/48.85833,2.30777/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.
lunit Length unit (either 'mi' or 'km') which overrides the default length units used in input and output.
distance Distance in miles (unless another unit is specified using lunit) defining the width and height of the bounding rectangle around the center when specified. Defaults to 10 miles. The maximum is 25 miles or 50 kilometers.
min_rating Filters results list of restaurants to those with a minimum overall rating. Input numbers between 1 and 5 including half bubbles (e.g. 3.0, 3.5).

 

Response

{
  "data": [
    {
      "address_obj": {
        "street1": "18 rue Amelie",
        "street2": "Metro la Tour-Maubourg Line 8",
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75007",
        "address_string": "18 rue Amelie Metro la Tour-Maubourg Line 8, 75007 Paris France"
      },
      "distance": ".01",
      "latitude": "48.858444",
      "rating": "4.5",
      "location_id": "4467359",
      "restaurant_booking": {
        "bookable": false,
        "booking_url": null
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/4467359?key=PARTNER_KEY",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d4467359-mMCID-Le_Crepuscule-Paris_Ile_de_France.html",
      "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"
        }
      ],
      "longitude": "2.30766",
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [
              {
                "open_time": "12:00",
                "close_time": "15:00"
              },
              {
                "open_time": "19:00",
                "close_time": "21:30"
              }
            ],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": 95,
      "bearing": "northwest",
      "cuisine": [
        {
          "name": "french",
          "localized_name": "French"
        }
      ],
      "ranking_data": {
        "ranking_string": "#59 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "59",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#2 of 325 Dessert in Paris"
        ]
      },
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d4467359-Reviews-mMCID-Le_Crepuscule-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": "Le Crepuscule",
      "num_reviews": "376",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d4467359-mMCID-Reviews-Le_Crepuscule-Paris_Ile_de_France.html#photos"
    },
    {
      "address_obj": {
        "street1": "11 B rue Amelie",
        "street2": "7th Arrondissement",
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75007",
        "address_string": "11 B rue Amelie 7th Arrondissement, 75007 Paris France"
      },
      "distance": ".04",
      "latitude": "48.8589",
      "rating": "4.5",
      "location_id": "2369146",
      "restaurant_booking": {
        "bookable": false,
        "booking_url": null
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/2369146?key=PARTNER_KEY",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d2369146-mMCID-Reed-Paris_Ile_de_France.html",
      "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"
        }
      ],
      "longitude": "2.307562",
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "19:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "19:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "19:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [
              {
                "open_time": "19:00",
                "close_time": "22:30"
              }
            ],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": 92,
      "bearing": "north",
      "cuisine": [
        {
          "name": "french",
          "localized_name": "French"
        },
        {
          "name": "european",
          "localized_name": "European"
        }
      ],
      "ranking_data": {
        "ranking_string": "#1,218 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "1218",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#1,158 of 14,172 Restaurants in Paris"
        ]
      },
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2369146-Reviews-mMCID-Reed-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": "Reed",
      "num_reviews": "214",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2369146-mMCID-Reviews-Reed-Paris_Ile_de_France.html#photos"
    },
    {
      "address_obj": {
        "street1": "11 Rue Amelie",
        "street2": "",
        "city": "Paris",
        "state": null,
        "country": "France",
        "postalcode": "75007",
        "address_string": "11 Rue Amelie, 75007 Paris France"
      },
      "distance": ".04",
      "latitude": "48.858906",
      "rating": "4.0",
      "location_id": "2199543",
      "restaurant_booking": {
        "bookable": false,
        "booking_url": null
      },
      "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/2199543?key=PARTNER_KEY",
      "write_review": "https://www.tripadvisor.com/UserReview-g187147-d2199543-mMCID-Gusto_Italia-Paris_Ile_de_France.html",
      "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"
        }
      ],
      "longitude": "2.30755",
      "hours": {
        "week_ranges": [
          {
            "localized_day_name": "Sunday",
            "times": [
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Sunday"
          },
          {
            "localized_day_name": "Monday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Monday"
          },
          {
            "localized_day_name": "Tuesday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Tuesday"
          },
          {
            "localized_day_name": "Wednesday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Wednesday"
          },
          {
            "localized_day_name": "Thursday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Thursday"
          },
          {
            "localized_day_name": "Friday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Friday"
          },
          {
            "localized_day_name": "Saturday",
            "times": [
              {
                "open_time": "11:30",
                "close_time": "15:00"
              },
              {
                "open_time": "18:30",
                "close_time": "23:00"
              }
            ],
            "day_name": "Saturday"
          }
        ],
        "timezone": "Europe/Paris"
      },
      "percent_recommended": 86,
      "bearing": "north",
      "cuisine": [
        {
          "name": "italian",
          "localized_name": "Italian"
        },
        {
          "name": "pizza",
          "localized_name": "Pizza"
        },
        {
          "name": "european",
          "localized_name": "European"
        }
      ],
      "ranking_data": {
        "ranking_string": "#2,950 of 16,797 Places to Eat in Paris",
        "ranking_out_of": "16797",
        "geo_location_id": "187147",
        "ranking": "2950",
        "geo_location_name": "Paris",
        "ranking_string_detail": [
          "#2,822 of 14,172 Restaurants in Paris"
        ]
      },
      "location_string": "Paris, Ile-de-France",
      "web_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2199543-Reviews-mMCID-Gusto_Italia-Paris_Ile_de_France.html",
      "price_level": "$$ - $$$",
      "rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-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": "Gusto Italia",
      "num_reviews": "152",
      "category": {
        "name": "restaurant",
        "localized_name": "Restaurant"
      },
      "subcategory": [
        {
          "name": "sit_down",
          "localized_name": "Sit down"
        }
      ],
      "see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g187147-d2199543-mMCID-Reviews-Gusto_Italia-Paris_Ile_de_France.html#photos"
    }
  ],
  "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.

restaurant_booking

 object

Includes whether a restaurant is bookable on thefork.com (a Tripadvisor company) and a direct booking link.
hours object

Provides localized opening hours for Restaurants and Attractions, using ISO 8601 format.
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.
distance number This field applies only for calls that pass in a latitude and longitude as input. It indicates the distance in the requested unit (miles or kilometers) between this location and the passed-in location. If no lunit parameter is passed in to specify the unit of measure, the default unit for the locale is used.
bearing string This field applies only for calls that pass in a latitude and longitude as input. It indicates the compass direction of this location relative to the passed-in location.