Call the API with the unique ID for a hotel, restaurant, attraction or destination. The response provides data such as: name, address, overall traveler rating, number of reviews, link to read all reviews, link to write reviews, recent review snippets, along with additional data elements. Some data elements may not output if they do not apply to the particular type of location.
| Name | Description |
|---|---|
| lang | The desired language locale. |
| currency |
currency code to use for request and response (should follow ISO 4217). |
| fulltext | When fulltext=true, the output of recent reviews will contain the full text of each review, the management response if one exists, and subratings. Otherwise, will output a review snippet truncated at 200 characters (no management response or subratings). If the API key does not have access to full text reviews the parameter will be ignored. |
{
"see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g60750-d781627-mMCID-The_Grand_Del_Mar-San_Diego_California.html",
"reviews": [
{
"id": "255810672",
"lang": "en",
"location_id": "781627",
"published_date": "2015-02-22T13:34:21-0500",
"rating": 5,
"helpful_votes": "1",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "http://www.tripadvisor.com/ShowUserReviews-g60750-d781627-r255810672-The_Grand_Del_Mar-San_Diego_California.html#review255810672",
"trip_type": "Couples",
"travel_date": "2015-02",
"text": "My wife and I wanted to get away for a couple of days for her birthday. We hadn't been to the San Diego area for a while and wanted a place where we could relax, plat golf and be a little pampered...",
"user": {
"username": "russell l",
"user_location": {
"id": "32147",
"name": "Camarillo, California"
}
},
"title": "Hidden wonder"
},
{
"id": "255451055",
"lang": "en",
"location_id": "781627",
"published_date": "2015-02-20T13:14:22-0500",
"rating": 5,
"helpful_votes": "5",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "http://www.tripadvisor.com/ShowUserReviews-g60750-d781627-r255451055-The_Grand_Del_Mar-San_Diego_California.html#review255451055",
"trip_type": "Friends getaway",
"travel_date": "2015-02",
"text": "From the Valet to even the managers at the Amaya restaurant the service was impeccable. I loved that all staff took care of tables. Even the managers where going around and get drink orders and...",
"user": {
"username": "James A",
"user_location": {
"id": "32978",
"name": "Riverside, California"
}
},
"title": "Service was unbelievable. Great weekend getaway"
},
{
"id": "255409713",
"lang": "en",
"location_id": "781627",
"published_date": "2015-02-20T09:39:59-0500",
"rating": 5,
"helpful_votes": "4",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "http://www.tripadvisor.com/ShowUserReviews-g60750-d781627-r255409713-The_Grand_Del_Mar-San_Diego_California.html#review255409713",
"trip_type": "Business",
"travel_date": "2015-02",
"text": "We were very lucky and enjoyed 4 days of warmth and sunshine poolside where the service is fabulous. They get your chaise ready for you, bring you ice water and had a wonderful poolside menu (fish...",
"user": {
"username": "Terri S",
"user_location": {
"id": "53154",
"name": "Meadowbrook, Pennsylvania"
}
},
"title": "Beautiful Property"
}
],
"web_url": "http://www.tripadvisor.com/Hotel_Review-g60750-d781627-Reviews-mMCID-The_Grand_Del_Mar-San_Diego_California.html",
"percent_recommended": null,
"location_string": "San Diego, California",
"location_id": "781627",
"write_review": "http://www.tripadvisor.com/UserReview-g60750-d781627-mMCID-The_Grand_Del_Mar-San_Diego_California.html",
"price_level": "$$$$",
}
}
},
"hotel_booking":{
"bookable": true,
"booking_url": "http://www.tripadvisor.com/Hotel_Review-g60750-d781627-Reviews-mMCID-The_Grand_Del_Mar-San_Diego_California.html"
},
"review_rating_count": {
"1": "6",
"2": "8",
"3": "22",
"4": "65",
"5": "875"
},
"address_obj": {
"street1": "5300 Grand Del Mar Court",
"street2": "",
"city": "San Diego",
"state": "California",
"country": "United States",
"postalcode": "92130",
"address_string": "5300 Grand Del Mar Court, San Diego, CA 92130"
},
"category": {
"name": "hotel",
"localized_name": "Hotel"
},
"subratings": [
{
"localized_name": "Sleep Quality",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_sleep",
"value": "5.0"
},
{
"localized_name": "Location",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss4.5.gif",
"name": "rate_location",
"value": "4.5"
},
{
"localized_name": "Rooms",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_room",
"value": "5.0"
},
{
"localized_name": "Service",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_service",
"value": "5.0"
},
{
"localized_name": "Value",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss4.5.gif",
"name": "rate_value",
"value": "4.5"
},
{
"localized_name": "Cleanliness",
"rating_image_url": "http://e2.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_cleanliness",
"value": "5.0"
}
],
"trip_types": [
{
"localized_name": "Business",
"name": "business",
"value": "209"
},
{
"localized_name": "Couples",
"name": "couples",
"value": "373"
},
{
"localized_name": "Solo travel",
"name": "solo",
"value": "17"
},
{
"localized_name": "Family",
"name": "family",
"value": "275"
}
],
"awards": [
{
"award_type": "Traveler's Choice",
"year": "2015",
"images": {
"tiny": "http://www.tripadvisor.com/img/cdsi/img2/awards/tchotel_tiny-MCID-5.png",
"small": "http://www.tripadvisor.com/img/cdsi/img2/awards/tchotel_2015_L_R-MCID-5.jpg",
"large": "http://www.tripadvisor.com/img/cdsi/img2/awards/TC_2015_downloadable_L_R-MCID-5.jpg"
},
"categories": [
"Luxury",
"Top Hotels"
],
"display_name": "Traveler's Choice"
},
{
"award_type": "GreenLeader",
"year": "",
"images": {
"small": "http://www.tripadvisor.com/img/cdsi/img2/awards/greenleader_small-MCID-5.gif",
"large": "http://www.tripadvisor.com/img/cdsi/img2/awards/greenleaders/GreenLeaders_API_en_large_silver-MCID-5.jpg"
},
"categories": [
"Silver level"
],
"display_name": "GreenLeader Silver"
},
{
"award_type": "Certificate of Excellence",
"year": "2014",
"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_2014_en_US_large-MCID-5.jpg"
},
"categories": [],
"display_name": "Certificate of Excellence 2014"
}
],
"num_reviews": "976",
"subcategory": [
{
"name": "hotel",
"localized_name": "Hotel"
}
],
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/5.0-MCID-5.svg",
"name": "The Grand Del Mar",
"ancestors": [
{
"abbrv": null,
"level": "Municipality",
"name": "San Diego",
"location_id": "60750"
},
{
"abbrv": "CA",
"level": "State",
"name": "California",
"location_id": "28926"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-117.19746",
"rating": "5.0",
"latitude": "32.938343",
"photo_count": "350",
"ranking_data": {
"geo_location_id": "60750",
"ranking_string": "#1 of 270 hotels in San Diego",
"geo_location_name": "San Diego",
"ranking_out_of": "270",
"ranking": "1"
}
}
| Field | 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. | ||||||||||
| 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. | ||||||||||
| 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. |
||||||||||
| restaurant_booking | object |
Includes whether a restaurant is bookable on thefork.com (a Tripadvisor company) and a direct booking url. |
||||||||||
| hours | object | Provides localized opening hours for Restaurants and Attractions, using ISO 8601 format. | ||||||||||
| reviews | objects | Includes detailed information about individual reviews for the requested POI. | ||||||||||
| 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. |
||||||||||
| review_rating_count | array | Count of reviews for this location at each traveler rating level (1,2,3,4,5). | ||||||||||
| subratings | object | Users may rate accomodations and restaurants against a number of subcategories, using the same 1 (terrible) to 5 (excellent) rating scale as the overall Bubble Ratings. Please note that attractions are not further rated against any subcategories. | ||||||||||
| trip_types | object | Each review submitted on Tripadvisor is tagged with a trip type, as designated by the reviewer. For each POI location, a breakdown of the total review count by trip type is included in the "trip_types" object. | ||||||||||
| 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.) |
||||||||||
| category_counts | array | Includes counts of each type of POI located in that destination, broken down by subcategory where applicable. | ||||||||||
| 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. | ||||||||||
| photo_count | number | The count of traveler photos for this POI published on Tripadvisor. | ||||||||||
| abbrv | string | Abbreviated version of the destination name if one exists (MA for Massachusetts for example). Null if not applicable. | ||||||||||
| 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. | ||||||||||
| see_all_hotels | URL | Link to the main accomodations page for the destination on Tripadvisor. | ||||||||||
| see_all_attractions | URL | Link to the main attractions page for the destination on Tripadvisor. | ||||||||||
| see_all_activities | URL | Link to the bookable activity list page for the destination or POI. Can be configured for a Tripadvisor or Viator URL depending on your business model. | ||||||||||
| see_all_restaurants | URL | Link to the main restaurants page for the destination on Tripadvisor. |
| Name | Description |
|---|---|
| attractions | Return a list of top attractions in this geographic location. |
| activities | Return a list of bookable activities in this geographic location. |
| hotels | Return a list of top hotels in this geographic location. |
| restaurants |
Return a list of top restaurants in this geographic location. |