POST /accommodations/reviews

This endpoint provides access to reviews for specified accommodations, allowing you to retrieve traveller feedback associated with a particular property. ✅ The reviews returned can be filtered and sorted, with the option to limit the number of reviews per accommodation by specifying the rows parameter. 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. 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.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

X-Affiliate-Id Integer Yes

Include here your Affiliate identifier number

Request body fields

Name Type Required Description
page String No

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

last_change String No

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

accommodations[] Array Yes
reviewer Object No
reviewer.types[] Array No

Limits reviews to those written by specific reviewer type.

reviewer.countries[] Array No

Limits reviews to those written by reviewer from the given country.

reviewer.travel_purposes[] Array No

Limits reviews to those written by specific travel purposes.

score Object No
score.minimum Integer No

Limits the reviews to those having score greater or equal to this value.

score.maximum Integer No

Limits the reviews to those having score lesser or equal to this value.

rows Integer No

The maximum number of results to return.

Default value: 100

languages[] Array No

Limits reviews to those written in this language.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.