When specifying a Lat/Long point, returns a list of 10 properties found within a given distance from that point. If there are more than 10 properties within the radius requested, the 10 nearest properties will be returned. In lieu of lat long, can specify a location ID and the output will return nearest POIs.
| Name | Description |
|---|---|
| lang | The desired language locale. |
| currency | currency code to use for request and response (should follow ISO 4217). |
| 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 thewidth 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 to those with a minimum overall rating. Input numbers between 1 and 5 including half bubbles (e.g. 3.0, 3.5). |
{
"data": [
{
"address_obj": {
"street1": "1502 Tremont St",
"street2": null,
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"postalcode": "02120-2927",
"address_string": "1502 Tremont St, Boston, MA 02120-2927"
},
"distance": ".04",
"latitude": "42.33205",
"rating": null,
"location_id": "4225110",
"restaurant_booking": {
"bookable": false,
"booking_url": null
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/4225110?key=PARTNER_KEY",
"write_review": "https://www.tripadvisor.com/UserReview-g60745-d4225110-mMCID-Chacho_s_Pizza_Subs-Boston_Massachusetts.html",
"ancestors": [
{
"abbrv": null,
"level": "City",
"name": "Boston",
"location_id": "60745"
},
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-71.09931",
"hours": null,
"percent_recommended": null,
"bearing": "north",
"cuisine": [],
"ranking_data": null,
"location_string": "Boston, Massachusetts",
"web_url": "https://www.tripadvisor.com/Restaurant_Review-g60745-d4225110-Reviews-mMCID-Chacho_s_Pizza_Subs-Boston_Massachusetts.html",
"price_level": null,
"rating_image_url": null,
"awards": [],
"name": "Chacho's Pizza & Subs",
"num_reviews": "0",
"category": {
"name": "restaurant",
"localized_name": "Restaurant"
},
"subcategory": [],
"see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g60745-d4225110-mMCID-Reviews-Chacho_s_Pizza_Subs-Boston_Massachusetts.html#photos"
},
{
"address_obj": {
"street1": "1514 Tremont St",
"street2": null,
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"postalcode": "02120-2928",
"address_string": "1514 Tremont St, Boston, MA 02120-2928"
},
"distance": ".05",
"latitude": "42.3321",
"rating": "3.0",
"location_id": "4198412",
"restaurant_booking": {
"bookable": false,
"booking_url": null
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/4198412?key=PARTNER_KEY",
"write_review": "https://www.tripadvisor.com/UserReview-g60745-d4198412-mMCID-Crispy_Dough_Pizzeria-Boston_Massachusetts.html",
"ancestors": [
{
"abbrv": null,
"level": "City",
"name": "Boston",
"location_id": "60745"
},
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-71.0996",
"hours": {
"week_ranges": [
{
"localized_day_name": "Sunday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Sunday"
},
{
"localized_day_name": "Monday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Monday"
},
{
"localized_day_name": "Tuesday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Tuesday"
},
{
"localized_day_name": "Wednesday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Wednesday"
},
{
"localized_day_name": "Thursday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Thursday"
},
{
"localized_day_name": "Friday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Friday"
},
{
"localized_day_name": "Saturday",
"times": [
{
"open_time": "11:00",
"close_time": "23:00"
}
],
"day_name": "Saturday"
}
],
"timezone": "America/New_York"
},
"percent_recommended": null,
"bearing": "north",
"cuisine": [
{
"name": "pizza",
"localized_name": "Pizza"
}
],
"ranking_data": {
"ranking_string": "#1,939 of 3,172 Places to Eat in Boston",
"ranking_out_of": "3172",
"geo_location_id": "60745",
"ranking": "1939",
"geo_location_name": "Boston"
},
"location_string": "Boston, Massachusetts",
"web_url": "https://www.tripadvisor.com/Restaurant_Review-g60745-d4198412-Reviews-mMCID-Crispy_Dough_Pizzeria-Boston_Massachusetts.html",
"price_level": null,
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.0-MCID-5.svg",
"awards": [],
"name": "Crispy Dough Pizzeria",
"num_reviews": "3",
"category": {
"name": "restaurant",
"localized_name": "Restaurant"
},
"subcategory": [],
"see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g60745-d4198412-mMCID-Reviews-Crispy_Dough_Pizzeria-Boston_Massachusetts.html#photos"
},
{
"address_obj": {
"street1": "1528 Tremont St",
"street2": "Mission Hill",
"city": "Boston",
"state": "Massachusetts",
"country": "United States",
"postalcode": "02120-2928",
"address_string": "1528 Tremont St Mission Hill, Boston, MA 02120-2928"
},
"distance": ".07",
"latitude": "42.33233",
"rating": "4.5",
"location_id": "2080094",
"restaurant_booking": {
"bookable": false,
"booking_url": null
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/2080094?key=PARTNER_KEY",
"write_review": "https://www.tripadvisor.com/UserReview-g60745-d2080094-mMCID-Lilly_s_Gourmet_Pasta_Express-Boston_Massachusetts.html",
"ancestors": [
{
"abbrv": null,
"level": "City",
"name": "Boston",
"location_id": "60745"
},
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-71.099976",
"hours": {
"week_ranges": [
{
"localized_day_name": "Sunday",
"times": [
{
"open_time": "12:00",
"close_time": "22:00"
}
],
"day_name": "Sunday"
},
{
"localized_day_name": "Monday",
"times": [
{
"open_time": "11:00",
"close_time": "22:00"
}
],
"day_name": "Monday"
},
{
"localized_day_name": "Tuesday",
"times": [
{
"open_time": "11:00",
"close_time": "22:00"
}
],
"day_name": "Tuesday"
},
{
"localized_day_name": "Wednesday",
"times": [
{
"open_time": "11:00",
"close_time": "22:00"
}
],
"day_name": "Wednesday"
},
{
"localized_day_name": "Thursday",
"times": [
{
"open_time": "11:00",
"close_time": "22:00"
}
],
"day_name": "Thursday"
},
{
"localized_day_name": "Friday",
"times": [
{
"open_time": "11:00",
"close_time": "00:00"
}
],
"day_name": "Friday"
},
{
"localized_day_name": "Saturday",
"times": [
{
"open_time": "11:00",
"close_time": "00:00"
}
],
"day_name": "Saturday"
}
],
"timezone": "America/New_York"
},
"percent_recommended": null,
"bearing": "northwest",
"cuisine": [
{
"name": "italian",
"localized_name": "Italian"
}
],
"ranking_data": {
"ranking_string": "#976 of 3,172 Places to Eat in Boston",
"ranking_out_of": "3172",
"geo_location_id": "60745",
"ranking": "976",
"geo_location_name": "Boston"
},
"location_string": "Boston, Massachusetts",
"web_url": "https://www.tripadvisor.com/Restaurant_Review-g60745-d2080094-Reviews-mMCID-Lilly_s_Gourmet_Pasta_Express-Boston_Massachusetts.html",
"price_level": "$$ - $$$",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-MCID-5.svg",
"awards": [],
"name": "Lilly's Gourmet Pasta Express",
"num_reviews": "6",
"category": {
"name": "restaurant",
"localized_name": "Restaurant"
},
"subcategory": [
{
"name": "sit_down",
"localized_name": "Sit down"
}
],
"see_all_photos": "https://www.tripadvisor.com/Restaurant_Review-g60745-d2080094-mMCID-Reviews-Lilly_s_Gourmet_Pasta_Express-Boston_Massachusetts.html#photos"
}
],
"paging": {
"next": null,
"previous": null,
"results": "3",
"total_results": "3",
"skipped": "0"
}
}
| 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:
|
||||||||||
| 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. | ||||||||||
|
attraction_booking |
object |
Includes whether an attraction is bookable and a list of available products with the title, starting price, description, inclusions & exclusions, departure information, product groups and categories, product photos, and detail page link. |
||||||||||
|
hotel_booking |
object |
Includes whether a hotel is bookable on Tripadvisor and booking url. |
||||||||||
|
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. |
||||||||||
| percent_recommended | number |
Deprecated - will be displayed as null. The percent of reviewers who recommend this location (rated 4/5 or higher). May not be present if there are are not enough reviews to calculate a percentage. |
||||||||||
| 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. | ||||||||||
| 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. Deprecated as of February 2017 for Attractions. Refer to the "groups" object for the most up to date classifications. |
||||||||||
| 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.) | ||||||||||
| attraction_types | object |
Deprecated as of February 2017. Use the "Groups" object for attraction hierarchy. Attractions can have one or more "attraction_types". These serve primarily descriptive purposes and will not work as filters. (These fields are only applicable for location type: attraction.) |
||||||||||
| groups | object | Hierarchical display of Attraction Groups and Categories. (These fields are only applicable for location type: attraction.) | ||||||||||
| 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. | ||||||||||
| 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. | ||||||||||
| 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. |
| Name | Description |
|---|---|
| attractions | Return attractions near the specified lat/long or location sorted by distance. |
| activities | Return a list of bookable activities in this geographic location. |
| hotels | Return hotels near the specified lat/long or location sorted by distance. |
| restaurants | Return all the restaurants near the specified lat/long or location sorted by distance. |