Sign in
latestOpenAPI 3.1.02026-08-10390815.4 KB

e5f3dccae7ca

Accommodations

Accommodation 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, 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.

post/accommodations/reviews

Headers

X-Affiliate-Idinteger required

Include here your Affiliate identifier number

Request body

accommodationsinteger[] required
languagesstring[]

Limits reviews to those written in this language.

last_changestring date

Limits the reviews to those changed after the given date. Format: YYYY-MM-DD.

pagestring

Pagination token used to retrieve the next page of results. Obtained from next_page.

rowsinteger

The maximum number of results to return.

Example request

{
  "languages": [
    "en-us"
  ],
  "reviewer": {
    "countries": [
      "nl"
    ]
  }
}

Response

Successful response.

request_idstring

Uniquely identifies the request. Please provide this identifier when contacting support.

next_pagestring nullable

Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter page).

Example response

{
  "data": [
    {
      "reviews": [
        {
          "language": "en-us",
          "reviewer": {
            "country": "nl"
          }
        }
      ]
    }
  ]
}