Documentation🖇 Quick LinksAPI
Documentation

Hotel Ranking and Reviews

Suggest Edits

HSP provides rating and reviews, the data been pulled from different suppliers: TrustYou, Expedia, Booking.com
in order to receive rating and reviews the client has to have a valid contract with at least one supplier.

This data can be simply and seamlessly integrated as part of hotels searching process, and to present it to end consumers.

Booking.com - Review Score

Booking.com’s review score, based on feedback from its customers, enables you to enhance your booking platform with real-time, customizable review content.

Once Booking.com is integrated as a connected supplier in your system, the relevant Details Levels will return the review score under the "HotelReviews" field.


📘

Note:

Refer to the applicable 'Detail Levels' that support the 'Booking.com' Rating value.

TrustYou

TrustYou reviews and rating empowers you to enhance your booking platforms with real-time and customizable review content .
Guest reviews and ratings offer crucial insights that travelers rely on when planning and booking their hotels .

👍

NOTE :

By default the response will neither contain TrustYou content, nor call reviews service, unless you have a contract signed with TrustYou.

You can contact 'TrustYou' team on [email protected] or [email protected] and once you have a contract signed with them, please contact us and we'll activate it for you.

Please be advised that you can retrieve TrustYou reviews only for hotels that were returned on the session and only by sending "ExcludeHotelDetails = False" in the search request.

TrustYou reviews and rating in the "SearchHotels"

Once a "Search Hotels" is initiated - the response will contain the following data :

FieldDescription
ReviewsOpening Element
CategoryListOpening Element
CategoryNameCategory being rated (Location, Breakfast, Room, Service, etc.)
CountNumber of reviews for this category
ScoreNumerical rating for the category
ShortTextShort text category summary
TextFull text category summary
CategoryListClosing Element
HotelTypeHotel Type text based on the reviews. (Excellent budget hotel, Good accommodation, Good accommodation. Fantastic service. Great location etc)
LanguageReviews Language
LocationHotel Location text based on the reviews. (Good for sightseeing with access to public transportation, Close to public transportation and the train station)
ReviewIdThe reviewId.
ReviewSourceSource of the reviews (TrustYou)
ReviewsCountCount of available reviews for the Hotel.
ReviewsDistributionOpening Element
ReviewsCountCount of reviews for this specific starts.
StarsStar Rating of the reviews.
ReviewsDistributionClosing Element
ScoreOverall score of the Hotel.
ScoreDescriptionThe Score's description (Very Good, Excellent, Poor etc.)
ScoreScaleThe score's scale (Default - 5).
TextOverall score of the Hotel - in text.
ScoreOverall score of the Hotel.
StarRatingStar Rating of the reviews.
TripAdvisorOpening Element
RatingStar Rating of the Hotel.
RatingImageUrlStar Rating Image of the Hotel.
ReviewsCountStar Rating review count.
TripAdvisorClosing Element

Response Example

"Reviews": [
						{
							"BadgeList": [
								{
									"BadgeType": "hotel_type",
									"SubText": "Top 1% in city",
									"Text": "Top 1% in city"
								},
								{
									"BadgeType": "hotel_type",
									"SubText": "Top 7% in city",
									"Text": "Top 7% in city"
								},
								{
									"BadgeType": "category",
									"SubText": "Top 8% in city",
									"Text": "Top 8% in city"
								},
								{
									"BadgeType": "category",
									"SubText": "Top 9% in city",
									"Text": "Top 9% in city"
								},
								{
									"BadgeType": "category",
									"SubText": "Top 10% in city",
									"Text": "Top 10% in city"
								}
							],
							"CategoryList": [
								{
									"CategoryName": "Service",
									"Count": 522,
									"Score": 96.0,
									"ShortText": "Fantastic service",
									"Text": "World class service."
								},
								{
									"CategoryName": "WiFi",
									"Count": 5,
									"Score": 95.0,
									"ShortText": "Good internet service",
									"Text": "Internet works perfectly."
								},
								{
									"CategoryName": "Location",
									"Count": 419,
									"Score": 95.0,
									"ShortText": "Great location",
									"Text": "Terrific location."
								},
								{
									"CategoryName": "Bar",
									"Count": 88,
									"Score": 93.0,
									"ShortText": "Bar is awesome",
									"Text": "Incredible bar."
								},
								{
									"CategoryName": "Cleanliness",
									"Count": 166,
									"Score": 91.0,
									"ShortText": "Clean",
									"Text": "Perfectly clean."
								},
								{
									"CategoryName": "Breakfast",
									"Count": 317,
									"Score": 91.0,
									"ShortText": "Tasty breakfast",
									"Text": "Excellent breakfast."
								},
								{
									"CategoryName": "Amenities",
									"Count": 147,
									"Score": 83.0,
									"ShortText": "Great amenities",
									"Text": "Amenities are good."
								},
								{
									"CategoryName": "Room",
									"Count": 420,
									"Score": 68.0,
									"ShortText": "Room is all right",
									"Text": "Rooms are ok."
								},
								{
									"CategoryName": "Comfort",
									"Count": 238,
									"Score": 47.0,
									"ShortText": "More comfort would be nice",
									"Text": "Not very comfortable."
								}
							],
							"HotelType": "Excellent budget hotel.",
							"Language": "en",
							"Location": "Good for sightseeing with easy access to train stations.",
							"ReviewId": "abfa5551-fb4b-4413-a992-604ce202fa1f",
							"ReviewSource": "TrustYou",
							"ReviewsCount": 1329,
							"ReviewsDistribution": [
								{
									"ReviewsCount": 18,
									"Stars": "1"
								},
								{
									"ReviewsCount": 23,
									"Stars": "2"
								},
								{
									"ReviewsCount": 76,
									"Stars": "3"
								},
								{
									"ReviewsCount": 427,
									"Stars": "4"
								},
								{
									"ReviewsCount": 785,
									"Stars": "5"
								}
							],
							"Score": 4.50,
							"ScoreDescription": "Excellent",
							"ScoreScale": 5,
							"Text": "Excellent budget hotel. Close to Roma Termini. Good for sightseeing with easy access to train stations."
						}
					],
					"Score": 194.16843280471889,
					"StarRating": "3",
					"TripAdvisor": {
						"Rating": 4.5,
						"RatingImageUrl": "https:\/\/carsolizeprod.blob.core.windows.net\/images\/TrustYou\/4_5.png",
						"ReviewsCount": 1320
					}

TrustYou - "GetHotelInfo" call

In addition to the hotel data provided during the "SearchHotel" step, there is an additional call called "GetHotelInfo" .

When initiating the "GetHotelInfo" call, the response will include comprehensive information, including the hotel's reviews URL, rating breakdown, reviews summaries, and more.

This data can be utilized to present valuable and vital information to assist clients in their booking process and decision-making.

Request Parameters

FieldExplanationMandatory
SessionIDThe session ID returned in the SearchHotels step✓
HotelIDHotelID (which returned in the SearchHotels response✓

Request Example

Endpoint: https://services.carsolize.com/Tripadvisor/Service.svc/json/GetHotelInfo

Example Request - JSON : 

{
	"rqst": {
		"__type": "GetHotelInfoRequest",
		"language": "en"
	},
	"sessionId": "/181/142423/D20240605T080531/f7d13008b0ec452e994c7c559a8e2243",
	"hotelId": 4091194
}

Example Response - JSON :

{
	"GetHotelInfoResult": {
		"AllReviewsUrl": "https:\/\/api.trustyou.com\/hotels\/84a71ea3-04cd-4e7d-a559-d506545d4095\/meta_review.html?lang=en&key=f1836b22-0422-47bc-8d5d-2c487fcde198",
		"HotelInfoResult": {
			"RatingBreakDown": [
				{
					"NumReviews": 1,
					"Score": 1
				},
				{
					"NumReviews": 1,
					"Score": 2
				},
				{
					"NumReviews": 5,
					"Score": 3
				},
				{
					"NumReviews": 4,
					"Score": 4
				},
				{
					"NumReviews": 10,
					"Score": 5
				}
			],
			"ReviewSummaries": [
				{
					"ContentSummary": "Clean.",
					"Language": "en",
					"RatingImageUrl": "https:\/\/carsolizeprod.blob.core.windows.net\/images\/TrustYou\/5.png",
					"Title": "Cleanliness"
				},
				{
					"ContentSummary": "Best value for money.;Good price",
					"Language": "en",
					"RatingImageUrl": "https:\/\/carsolizeprod.blob.core.windows.net\/images\/TrustYou\/5.png",
					"Title": "Value"
				},
				{
					"ContentSummary": "Great room.;Great rooms",
					"Language": "en",
					"RatingImageUrl": "https:\/\/carsolizeprod.blob.core.windows.net\/images\/TrustYou\/4_5.png",
					"Title": "Room"
				}
			]
		},
		"UserReviewResult": {}
	}
}

Please note the AllReviewsUrl tag, links to a webpage that displays even more information, and can be displayed on your website as well.

👍

NOTE :

If the response shows an error or "No reviews retrieved" this typically occurs because reviews are not available from TrustYou.

Updated 24 days ago