Sign in
latestOpenAPI 3.0.12026-08-101058136.3 KB

0fbdc2f4423a

demand-api-v2-compatible

List accommodation reviews

Returns reviews for specified hotel_ids and filters. Available filters are country, language of the review, lower and upper bound of the review score, and timestamp of the last change to the review. The 'last_change' output field will only be displayed if the last_change=... input parameter is set.

get/demand-api-v2-compatible/reviews

Query parameters

hotel_idsinteger[] required

List of hotel ids for which reviews should be displayed.

language'ar' | 'bg' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-gb' | 'en-us' | 'es' | 'es-ar' | 'es-mx' | 'et' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'ko' | 'lt' | 'lv' | 'ms' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'th' | 'tl' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-cn' | 'zh-tw'

Limits reviews to those written in this language (default: 'en'). Also sets the language of extras=review_score_word.

countrystring

Limits reviews to those written by bookers from the given country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.

offsetinteger

The number of rows to offset the results by.

rowsinteger

The maximum number of rows to return.

last_changestring

Limits the reviews to those changed after the given date in Europe/Amsterdam time zone. Format: 'yyyy-MM-dd HH:mm:ss'.

score_lower_boundinteger

Limits the reviews to those having score greater or equal to this value. Possible values are natural numbers in range [1 - 10].

score_upper_boundinteger

Limits the reviews to those having score lesser or equal to this value. Possible values are natural numbers in range [1 - 10].

extras'REVIEW_SCORE_WORD'

Specify here what extra items of the result should be included. See the endpoint description for more detailed information about each extra.

{
  "country": "nl",
  "last_change": "2025-11-20 14:05:30"
}

Response

OK

Example response

{
  "result": [
    {
      "date": "2025-11-20 14:05:30",
      "last_change": "2025-11-20 15:05:30"
    }
  ]
}