TripAdvisor guest ratings are available to all partners, free of charge and are exposed directly within the EAN API.

To feature TripAdvisor ratings and review counts on your site, you must first integrate the TripAdvisor elements, following all usage and display requirements outlined in the guideline document. EAN will onboard partners who agree to comply with the TripAdvisor guidelines.


TripAdvisor reserves the right to withhold/remove access to the TripAdvisor content, even after authorization is approved, at any time.


Hotel List Request Parameters (optional)

Name Value Required Description
minTripAdvisorRating float no Minimum TripAdvisor rating desired for properties returned. Request a value between 0.0 and 5.0.
maxTripAdvisorRating float no Maximum TripAdvisor rating desired for properties returned. Request a value between 0.0 and 5.0.
sort string no Send the value TRIP_ADVISOR to sort results from high to low TripAdvisor ratings.

Response Content

These elements will return within different parent elements, depending on the originating request.

For hotel list and hotel info requests, these elements will return within HotelSummary.
For room availability requests, these elements will return directly within the parent response element.


Name Value Description
tripAdvisorRating float The average TripAdvisor guest rating for the property. Range between 0.0 and 5.0.
tripAdvisorReviewCount int Number of guest reviews available for the property.
tripAdvisorRatingUrl string Image URL for the rating. Display of the rating image is required per TripAdvisor's contract.


Examples

These response excerpts highlight where TripAdvisor elements will return for each method.

Hotel List Response
<HotelList size="25" activePropertyCount="230">
<HotelSummary order="0" ubsScore="469713141">
<hotelId>115072</hotelId>
<name>Fairmont Olympic Hotel</name>
<address1>411 University St</address1>
<city>Seattle</city>
<stateProvinceCode>WA</stateProvinceCode>
<postalCode>98101</postalCode>
<countryCode>US</countryCode>
<airportCode>SEA</airportCode>
<supplierType>E</supplierType>
<propertyCategory>1</propertyCategory>
<hotelRating>5.0</hotelRating>
<confidenceRating>52</confidenceRating>
<amenityMask>24617091</amenityMask>
<tripAdvisorRating>4.5</tripAdvisorRating>
<tripAdvisorReviewCount>1190</tripAdvisorReviewCount>
<tripAdvisorRatingUrl>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-39958-4.png</tripAdvisorRatingUrl>


Hotel Info Response
  <HotelSummary order="0">
<hotelId>122212</hotelId>
<name>Luxor Hotel and Casino</name>
<address1>3900 S. Las Vegas Blvd</address1>
<city>Las Vegas</city>
<stateProvinceCode>NV</stateProvinceCode>
<postalCode>89119</postalCode>
<countryCode>US</countryCode>
<propertyCategory>3</propertyCategory>
<hotelRating>3.5</hotelRating>
<tripAdvisorRating>3.5</tripAdvisorRating>
<tripAdvisorReviewCount>13877</tripAdvisorReviewCount>
<tripAdvisorRatingUrl>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/3.5-39958-4.png</tripAdvisorRatingUrl>


Room Availability Response
    <hotelId>106347</hotelId>
<arrivalDate>05/30/2014</arrivalDate>
<departureDate>06/02/2014</departureDate>
<hotelName>MCM Elegante Hotel & Suites</hotelName>
<hotelAddress>2330 W Northwest Hwy</hotelAddress>
<hotelCity>Dallas</hotelCity>
<hotelStateProvince>TX</hotelStateProvince>
<hotelCountry>US</hotelCountry>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<checkInInstructions>{removed for brevity}</checkInInstructions>
<tripAdvisorRating>4.0</tripAdvisorRating>
<tripAdvisorReviewCount>163</tripAdvisorReviewCount>
<tripAdvisorRatingUrl>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-39958-4.png</tripAdvisorRatingUrl>