---
title: "List accommodation review scores"
method: GET
path: "/demand-api-v2-compatible/reviewScores"
tags: ["demand-api-v2-compatible"]
---

# List accommodation review scores

`GET /demand-api-v2-compatible/reviewScores`

Gives information about review scores for specified hotel_ids and filter.
The information consists of score breakdown per reviewer_type and review questions,
and overall score distribution per score value (1 - 10).

The available filter is input parameter reviewer_type=... .
It allows generating review score information for just one reviewer type.

Language in which the response is rendered can be controlled with the input parameter language=...
(default: 'en'). Setting the language will reflect on the output fields question and review_score_word.

One additional output field can be requested with input parameter extras=review_score_word.

## Query parameters

- `reviewScoresInputDto` ReviewScoresInputDto, required
  - `hotel_ids` integer[], required — List of hotel ids for which review score information should be displayed.
  - `affiliate_id` integer — Can be used to specify the affiliate id that should be used instead of the default one.
  - `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' — Code of the language used to render response. Please check the "Possible Values" section of the documentation for the accepted language codes.
  - `reviewer_type` 'SOLO_TRAVELLER' | 'YOUNG_COUPLE' | 'MATURE_COUPLE' | 'FAMILY_WITH_YOUNG_CHILDREN' | 'FAMILY_WITH_OLDER_CHILDREN' | 'WITH_FRIENDS' | 'GROUP' | 'REVIEW_CATEGORY_COUPLES' | 'REVIEW_CATEGORY_FAMILIES' | 'REVIEW_CATEGORY_GROUP_OF_FRIENDS' | 'REVIEW_CATEGORY_BUSINESS_TRAVELLERS' — Limits reviews to those written by specific reviewer type.

## Headers

- `Accept` 'application/json, application/xml'

## Response `200`

OK

- ResponseOutputV2ReviewScoresOutputDto
  - `meta` Meta
    - `ruid` string
  - `result` ReviewScoresOutputDto[]
    - `hotel_id` integer — Id of the hotel.
    - `hotel_url` string — URL of the hotel's page on Booking.com.
    - `score_breakdown` ScoreBreakdown[] — A breakdown of scores per reviewer type and review question.
      - `average_score` number, double — Average score from this reviewer type.
      - `count` integer — Number of responses from this reviewer type.
      - `question` QuestionDto[] — Review scores per question.
        - `count` integer — Number of reviewers that answered the question.
        - `question` string — Localized question text. See language=... input parameter.
        - `question_literal` string — Question literal.
        - `score` number, double — Average score that reviewers provided in response to this question.
      - `reviewer_type` string — Reviewer type.
    - `score_distribution` ScoreDistribution[] — A breakdown of all review scores into buckets 1 - 10.
      - `count` integer — Total number of reviews in this bucket.
      - `percent` number, double — Percent of score distribution that went into this bucket.
      - `score` integer — The bucket's review score value (1 - 10).

## Other responses

- `400` — Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.
- `500` — An unexpected server error occurred.

---

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