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
- https://demandapi.booking.com/3.1
- https://demandapi-sandbox.booking.com/3.1
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 |
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
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.