Sign in
latestOpenAPI 3.0.12026-08-101058136.3 KB

0fbdc2f4423a

demand-api-v2-compatible

List accommodation review scores

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.

get/demand-api-v2-compatible/reviewScores

Query parameters

hotel_idsinteger[] required

List of hotel ids for which review score information should be displayed.

affiliate_idinteger

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

OK

Example response

{
  "result": [
    {
      "hotel_url": "https://www.booking.com/hotel/nl/amsterdam-canal-hotel.html?tab=4&aid=338734&label=hotel-472820_reviewscore",
      "score_breakdown": [
        {
          "average_score": 8.5,
          "question": [
            {
              "score": 8.5
            }
          ]
        }
      ],
      "score_distribution": [
        {
          "count": 435,
          "percent": 17.76,
          "score": 10
        }
      ]
    }
  ]
}