Access to review content is dependent on the terms of use agreement between Tripadvisor and each individual partner. You may not have access to all calls, fields, and functionality. Contact your Account Manager with any questions.
Full text recent reviews can be retrieved from the /location-reviews call. If the review includes a management response, it will be outputted in the response. You can specify the desired language in the query parameter.
http://api.tripadvisor.com/api/partner/2.0/location/258705/reviews?lang=en_US&key=PARTNER_KEY
{
"data": [
{
"id": "368580653",
"lang": "en",
"location_id": "258705",
"published_date": "2016-04-28T16:12:32-0400",
"rating": 5,
"helpful_votes": "0",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60745-d258705-r368580653-mMCID-Hotel_Commonwealth-Boston_Massachusetts.html#review368580653",
"trip_type": "Business",
"travel_date": "2016-04",
"text": "Here in Boston with a group for work. After talking with a few hotels group reservation departments about our needs it became apparent to me the Hotel Commonwealth stood out from the rest. Sometimes you get a get a great feeling about a place up front but once you strike a deal and they \"have\" you things change. Well I have to say with the HC things only got better. In my business there are always last minute changes, new priorities etc. The staff at the hotel could not have been more helpful and understanding. It felt as if I had my own personal assistant. The rooms were great, the meeting space fantastic with some really unique baseball themed spaces that overlooked Fenway Park in the distance. I've found a new home away from home in Boston. Ask for Sheb when there, you won't be disappointed.",
"user": {
"username": "Greg G",
"user_location": {
"name": null,
"id": null
}
},
"title": "Beautiful Hotel, Fantastic Service!",
"owner_response": null,
"subratings": [
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_value",
"value": "5",
"localized_name": "Value"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_location",
"value": "5",
"localized_name": "Location"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_service",
"value": "5",
"localized_name": "Service"
}
]
},
{
"id": "368579105",
"lang": "en",
"location_id": "258705",
"published_date": "2016-04-28T15:59:08-0400",
"rating": 5,
"helpful_votes": "0",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60745-d258705-r368579105-mMCID-Hotel_Commonwealth-Boston_Massachusetts.html#review368579105",
"trip_type": "Business",
"travel_date": "2016-04",
"text": "I stayed at the Hotel Commonwealth as part of a corporate group; my group threw several curveballs at the staff...Sheb & Felicia in particular (Front Desk Managers). I'm happy to say that they came through with EVERYTHING we needed! ...And it wasn't easy. ;-) I will definitely recommend this hotel to my colleagues and would happily stay at the Hotel Commonwealth again. The rooms are lovely, but the people push it over the top. Thank you to everyone at the Hotel who's made our trip a success!",
"user": {
"username": "edowney3",
"user_location": {
"name": "Los Angeles, California",
"id": "32655"
}
},
"title": "Sheb & Felicia Are AMAZING!",
"owner_response": null,
"subratings": [
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_room",
"value": "5",
"localized_name": "Rooms"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_sleep",
"value": "5",
"localized_name": "Sleep Quality"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_service",
"value": "5",
"localized_name": "Service"
}
]
},
{
"id": "368578635",
"lang": "en",
"location_id": "258705",
"published_date": "2016-04-28T15:54:59-0400",
"rating": 5,
"helpful_votes": "0",
"rating_image_url": "http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-MCID-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60745-d258705-r368578635-mMCID-Hotel_Commonwealth-Boston_Massachusetts.html#review368578635",
"trip_type": "Business",
"travel_date": "2016-04",
"text": "I recently stayed and worked out of the Hotel Commonwealth for a large commercial project we were shooting in Boston. Our experience here was fantastic from start to finish. The staff and facility are beyond amazing!",
"user": {
"username": "cmsgPortlandMe",
"user_location": {
"name": "portland me",
"id": null
}
},
"title": "Sheb is the man at Hotel Commonwealth!",
"owner_response": null,
"subratings": [
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_value",
"value": "5",
"localized_name": "Value"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_location",
"value": "5",
"localized_name": "Location"
},
{
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss5.0.gif",
"name": "rate_service",
"value": "5",
"localized_name": "Service"
}
]
}
],
"paging": {
"next": null,
"previous": null,
"results": "3",
"total_results": "3",
"skipped": "0"
}
}
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | number | The Tripadvisor ID for the review. | ||||||||||
| location_id | number | Unique Tripadvisor location ID of the destination or POI. | ||||||||||
| 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. | ||||||||||
| title | string | The title of this review. | ||||||||||
| text | string | The full text of the review. | ||||||||||
| subratings | string | Users may additionally rate accommodations and restaurants by providing subratings for categories such as service/value/cleanliness/etc..., 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. | ||||||||||
| owner_response | object | Management Response to this review, if one exists. | ||||||||||
| trip_type | string | Trip type of the review (Business, Couples, Family, Friends, Solo). | ||||||||||
| published_date | date | The date the review was published to Tripadvisor. | ||||||||||
| is_machine_translated | bool | True of false. Is this a machine-translated review. (Outputs only if partner configured for inclusion of machine-translated reviews) | ||||||||||
| user | object | Display name and geographic location for the author of this review. For some partners, the user avatar is also available. | ||||||||||
| paging | object | Information required to browse the next and previous sets of reviews in the list, if they were not all returned as part of the current call. |
Reviews can be collected in Partnerships with Tripadvisor using the Review Collection Platform. To retrieve jointly collected reviews from the API, append the [ all_shared=true] query parameter to the api call.
You can specify the language in the query parameters.
You can retrieve jointly collected reviews OR you can retrieve recent 5 reviews as detailed above. You cannot retrieve both types in the same API call.
Data elements returnef for recent reviews are also returned for jointly collected reviews. Two additional data elements are outputted for jointly collected reviews: partner_crawlable and mcid
http://api.tripadvisor.com/api/partner/2.0/location/3736728/reviews?lang=en_us&all_shared=true&key=PARTNER_KEY
| Name | Type | Description |
|---|---|---|
| mcid | number | Marketing campaign ID for shared reviews. |
| partner_crawlable | bool | If true, review is not indexed on Tripadvisor, and may be search engine crawlable on the partner site. (Applies to a limited set of review collection platform partners.) |
Recent review snippets, 200 characters in length, are returned as a “reviews” array object in the main /location call (not the /location-reviews call) Management responses are not returned with snippets.
| Name | Description |
|---|---|
| lang | The desired language locale. Full list of valid language codes is here. This affects the URLs, subrating labels, and trip_type output. |
| preferred_lang | The preferred language for reviews. Reviews written in the preferred language are returned first, although additional reviews may be returned in other languages if there are not enough reviews in the preferred language. Values are as for lang, plus ALL which includes all possible languages. Defaults to the value of the lang parameter. |
| trip_type | Filters results list of reviews based on trip type. Valid trip types are: Business, Couples, Family, Friends, Solo. (applies to limited set of partners). |
| all_shared | If true, return all shared reviews (Review Collection Partners only). |