Search a hotel's guest reviews
Guest reviews for a hotel, newest first: rating, pros, cons and the provider. Filter by topic with ?topics=breakfast,pool and by cohort with ?guest-type=. Quote a review against metadata.totalCandidates, and cite metadata.matchedTerms for the word actually matched.
Path parameters
The hotel's numeric id (a positive integer), as carried by hotel search results (results[].hotelId) and embedded in a rate id.
Query parameters
Page number, 1-based (max 100). Defaults to 1.
Reviews per page (1-50). Defaults to 10.
Sort order. posted_at_desc (default, newest first) – a review corpus answers 'what is it like now', so recency opens; rating_desc / rating_asc sort by the provider's rating.
Response language tag (e.g. en, ar). Defaults to en.
Optional topic terms to filter reviews by (repeat or comma-separate, OR'd together) – e.g. ?topics=breakfast,pool keeps reviews mentioning either. metadata.matchedTerms reports the variants actually matched (breakfast, Breakfast).
Optional reviewer-cohort filter: couple, family_with_children, solo_traveller or extended_group.
Response projection. default: rating, title, pros, cons, provider. detail: adds the reviewer's country code and neutral prose notes. Defaults to default.
Response
One page of guest reviews.