Hotel reviews

GET/hotels/reviews

This call needs a hotel id and no search token. The id is id on a result, or hotelId on a location whose type is hotel. Each page has 10 reviews. A hotel with thousands of reviews still answers in under a second.

Filters

sortBy is recent, oldest, highestScore, or lowestScore. travelerTypes is a comma-separated list of families, couples, solo, friends, and business. months is a comma-separated list of month numbers, 1 through 12. sources is booking, agoda, priceline, or a mix. search keeps reviews that mention the text.

An unknown hotel id returns 200 with totalReviews: 0 and an empty reviews list. A non-numeric id, a bad sort, or a month outside 1–12 returns 400 and names the parameter. If the review service itself fails, the response is 502 REVIEWS_UNAVAILABLE.

Parameters

Query parameters.

hotelIdstringRequired

The id of a hotel from /hotels/results, or hotelId on a location whose locationType is hotel. Digits only. No search token.

sortBystring

How to order the reviews. Defaults to recent.

Possible values

recent

Default. Newest stay first.

oldest

Oldest stay first.

highestScore

Highest score first.

lowestScore

Lowest score first.

travelerTypesstring

Comma-separated. Keep reviews from these travellers. Any other value is rejected.

Possible values

families

Families.

couples

Couples.

solo

Solo travellers.

friends

Friends.

business

Business travellers.

monthsstring

Comma-separated months of the stay, 1 through 12. 10,11 is October and November. Month names are rejected.

sourcesstring

Comma-separated sites to read reviews from. Omit it to read all three.

Possible values

booking

Booking.com.

agoda

Agoda.

priceline

Priceline.

searchstring

Only reviews that mention this text. Up to 100 characters.

pageinteger

1-based page. Each page has 10 reviews. Defaults to 1.

Returns

A successful response, captured live.

                        {
  "hotelId": "5782",
  "totalReviews": 396,
  "page": 1,
  "hasMore": true,
  "reviews": [
    {
      "id": "r7tKjqEBLNjwf3gzyjSF",
      "score": 10,
      "label": "Excellent",
      "date": "2026-10",
      "author": "Terence",
      "positive": "Staff went over and above and a beautiful pleace",
      "negative": "Dining room was dusty and dirts where they sat us in the corner.",
      "comment": null,
      "source": "Booking.com",
      "url": "https://www.booking.com/hotel/gb/threadneedles-london.en.html?tab=4"
    },
    {
      "id": "PMAxRqEB3jszjc9nSern",
      "score": 10,
      "label": "Excellent",
      "date": "2026-10",
      "author": "Mark",
      "positive": null,
      "negative": "nothing",
      "comment": null,
      "source": "Booking.com",
      "url": "https://www.booking.com/hotel/gb/threadneedles-london.en.html?tab=4"
    }
  ]
}

reviews.