---
title: "Accommodation reviews"
method: POST
path: "/accommodations/reviews"
tags: ["Accommodations"]
---

# Accommodation reviews

`POST /accommodations/reviews`

This endpoint provides access to reviews for specified accommodations, allowing you to retrieve traveller feedback associated with a particular property.</br></br> ✅ The reviews returned can be [filtered and sorted](/demand/docs/accommodations/filter-sorting), with the option to limit the number of reviews per accommodation by specifying the `rows` parameter.</br></br> Please note that the ratings **score is based on all traveller traffic across Booking.com**, and may not necessarily reflect the experience of your own customers.</br></br> If you choose to display or use these ratings and reviews, you are responsible for ensuring that your travellers are properly informed about what these scores represent.

## Headers

- `X-Affiliate-Id` integer, required

## Request body

- object
  - `accommodations` integer[], required
  - `languages` string[] — Limits reviews to those written in this language.
  - `last_change` string, date — Limits the reviews to those changed after the given date. Format: YYYY-MM-DD.
  - `page` string — Pagination token used to retrieve the next page of results. Obtained from `next_page`.
  - `reviewer` object
    - `countries` string[] — Limits reviews to those written by reviewer from the given country.
    - `travel_purposes` string[] — Limits reviews to those written by specific travel purposes.
    - `types` string[] — Limits reviews to those written by specific reviewer type.
  - `rows` integer — The maximum number of results to return.
  - `score` object
    - `maximum` integer — Limits the reviews to those having score lesser or equal to this value.
    - `minimum` integer — Limits the reviews to those having score greater or equal to this value.

## Response `200`

Successful response.

- object
  - `request_id` string — Uniquely identifies the request. Please provide this identifier when contacting support.
  - `data` object[]
    - `id` integer — A signed integer number that uniquely identifies an accommodation property. The full list can be obtained by calling [accommodations/details](/demand/docs/open-api/demand-api/accommodations/accommodations/details).
    - `reviews` object[]
      - `id` integer — Unique identifier of the review.
      - `date` string, date — The date when the review was last modified. Format: YYYY-MM-DD.
      - `language` string — An IETF language tag code that uniquely identifies a supported human language or dialect as described here: https://en.wikipedia.org/wiki/IETF_language_tag. Note that in v3 the whole tag is always lowercase. Examples: "nl" for Dutch/Nederlands or "en-us" for English (US). To retrieve the full list of supported languages, call the `/common/languages` endpoint in the same Demand API version you are using.
      - `negative` string, nullable — Negative comments from this review.
      - `positive` string, nullable — Positive comments from this review.
      - `reviewer` object
        - `country` string — A two-letter code that uniquely identifies a 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. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonlocations/common/locations/countries" target="_blank">common/locations/countries</a>.
        - `name` string, nullable — Name of the reviewer. If the value is null then the reviewer is anonymous.
        - `travel_purpose` 'business' | 'leisure' — Defines if this was a leisure or business trip.
        - `type` 'couple' | 'extended_group' | 'family_with_children' | 'solo_traveller' — The reviewer type.
      - `score` number — The aggregated score of the review.
      - `summary` string, nullable — The summary of the review.
      - `text_meets_guidelines` boolean — Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines.
    - `url` string, url — Internet address for the property page on Booking.com.
  - `next_page` string, nullable — Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter `page`).

---

[API](https://skmtc.net/booking/apis/booking-com-demand-api.md) · [All operations](https://skmtc.net/booking/apis/booking-com-demand-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/booking-com-demand-api/revisions/e5f3dccae7ca/schema)