This feed includes review data for a property including date published, rating, review url, review text, author, author avatar, management responses, and other details.
The data model for the feed can be seen in the resources below. Note the displayed data model is generic and might have differences to the ones served to Partners. Partners should make sure to their existing contracts to identify which datasets are available in their own feeds.
XML Schema: https://tripadvisor-hs-standard-content-feed.s3.amazonaws.com/schemas/tripadvisor_reviewlist.xsd
JSON Schema: https://tripadvisor-hs-standard-content-feed.s3.amazonaws.com/schemas/tripadvisor_reviewlist.json
| Field Name | Description |
| id | Unique Tripadvisor location ID of the destination or POI. |
| cityId | unique ID of the location city |
| countryId | unique ID of the location country |
| name | Name of the property as listed on TA. |
| ratingImageUrl | The rating image usable in search results |
| averageRating | Average rating on TripAdvisor |
| reviewCount | Number of reviews on TripAdvisor |
| subRatings - name - value |
Value of a subrating, additional field or custom question. |
| Reviews: [] | The list of reviews |
| - id | review id |
| - ModerationStatus | urrent moderation status of the review. |
| - DatePublished | The date and time the review was published on the site. Format "yyyy-MM-dd'T'HH:mm:ss.SSSZ" (i.e., 2001-07-04T12:08:56.235-0700). |
| - ReviewUrl | The URL for the review on TripAdvisor |
| - MoreReviewsUrl | The URL for the more reviews for this property on TripAdvisor |
| - Rating | The overall rating of the review. |
| - RatingImageUrl | |
| - Language | The language of the review. |
| - MachineTranslated | |
| - Title | The title of the review. |
| - Text | The review text. |
| - Author - AuthorName - Location - SmallAvatarURL - LargeAvatarURL |
Information about the author of the review. - The displayable name of the review author. May be either first name and last initial, or screen name. - The location of the review author. |
| - TripType | The type of trip |
| - ReviewSubRatings | Review subratings. Sequence of ReviewSubRating elements. |
| - name | The name of the subrating. Current subrating names are: Value, Rooms, Location, Cleanliness, Service, SleepQuality. |
| - value | |
| - DateOfStay | |
| - ManagementResponse - id - ModerationStatus - DatePublished - Language - Text |
Management response for the review - The TripAdvisor ID of the management response - Current moderation status of the review. |
| - Author - AuthorName - Location - SmallAvatarURL - LargeAvatarURL |
Information about the author of the management response |
| - Photos []: | One to many photos |
| - ThumbnailURL | URL to the thumbnail size for this image, will always be 50x50 |
| - LargeThumbnailURL | URL to the large thumbnail size for this image, will always be 150x150 |
| - FullSizeURL | URL to the full size for this image |
| - StandardSizeURL | URL to the standard size for this image |
| - OriginalSizeURL | URL to the original size for this image |
Example:
<Property id="72179" cityid="28995" countryid="191">
<Name>Hotel Finial</Name>
<Reviews>
<Review id="369476225">
<ModerationStatus>Published</ModerationStatus>
<DatePublished>2016-05-02T07:10:49.123-0400</DatePublished>
<ReviewURL>/ShowUserReviews-g28995-d72179-r369476225-m27636-Hotel_Finial-Anniston_Alabama.html</ReviewURL>
<Rating>1</Rating>
<Language>en</Language>
<Title>NO AIR !!</Title>
<Text>Paid over 300 bucks to sleep in a suite and the the temperature was 78 degrees !!!! In the room !! Miserable nite!Was given a complimentary drink for our trouble . It's a really nice place . Room was spotless .Staff was friendly . It was just to hot to sleep !!!!</Text>
<Author>
<AuthorName>Ken M</AuthorName>
</Author>
<TripType>Couples</TripType>
<ManagementResponse id="372433976">
<ModerationStatus>Published</ModerationStatus>
<DatePublished>2016-05-12T16:47:08.835-0400</DatePublished>
<Language>en</Language>
<Text>Dear Ken M: We deeply apologize for the issue with the air conditioner. I don't blame you for being upset. We attempted to correct the issue as soon as possible and I understand that you were given a discount on the room in addition to the free drink. If that is not the case, please let us know so that we can make it right. This issue has been repaired and again, we apologize for the inconvenience.</Text>
<Author>
<AuthorName>Neal J</AuthorName>
<SmallAvatarURL height="50" width="50">http://media-cdn.tripadvisor.com/media/photo-t/01/2a/fd/a1/avatar.jpg</SmallAvatarURL>
<LargeAvatarURL height="205" width="205">http://media-cdn.tripadvisor.com/media/photo-f/01/2a/fd/a1/avatar.jpg</LargeAvatarURL>
</Author>
</ManagementResponse>
</Review>