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

# Accommodation review scores

`POST /accommodations/reviews/scores`

This endpoint returns score distribution and score breakdown for the specified accommodations. The scores information can be filtered by reviewer parameters and languages.

## Headers

- `X-Affiliate-Id` integer, required

## Request body

- object
  - `accommodations` integer[], required
  - `languages` string[] — Limits reviews to those written in this language.
  - `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.

## 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).
    - `breakdown` object — Review scores breakdown for each criteria. List of criteria includes: cleanliness, comfort, facilities, free_wifi, location, staff, value_for_money.
    - `distribution` object — Overall score distribution for each score (1-10).
    - `number_of_reviews` integer — Number of validated reviews for this accommodation.
    - `score` number — A decimal number indicating the current review score of this accommodation property, in the range 1..10.
    - `url` string, url — Internet address for the property page on Booking.com.

---

[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)