Attraction review scores

Booking.com Demand API (3.2 Beta)

3.2 Beta

These endpoints are only available in Beta.

Limited access: This API is currently offered to a limited number of pilot affiliate partners. For inquiries regarding participation, please contact our partnerships team.
Active development: These are under active development and subject to change.
Frequent updates: These API specifications will be regularly updated throughout the pilot. We recommend checking the changelog page periodically for the latest changes.

Note: Authentication is required using your Affiliate ID and token credentials.

Download OpenAPI description

demand-api.json

demand-api.yaml

Servers

Production environment

https://demandapi.booking.com/3.2/Beta/

Sandbox environment

https://demandapi-sandbox.booking.com/3.2/Beta/

Car rentals

3.2 Beta

Find here only the new car rental endpoints, which are part of the 3.2 Beta version and still under active development.

Use these endpoints to test the complete Search, look, and book flow for car rentals, including checking availability, retrieving terms and conditions, and creating an order.
See Demand API version 3.2 for other car rental endpoints.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Attractions

| 3.2 Beta | New |

The Attractions API collection introduces a new travel service asset within the Demand API.

Use these endpoints to search for attractions, retrieve detailed information, and store static data.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Attraction reviews

Request

| 3.2 Beta | New |

Use this endpoint to retrieve traveller reviews for a specific attraction, using a valid attraction ID.

The response can be filtered by language and sorted according to your preferences.
You can also limit the number of reviews returned per request using the rows parameter and paginate through results using the page token.

Important: Ratings reflect aggregated feedback from all Booking.com travellers and may not represent your own users’ experiences. You are responsible for communicating the context and meaning of these scores if displayed.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

attractionstringrequired

Uniquely identifies an attraction to retrieve reviews for.

languagestring[a-z]{2}(-[a-z]{2})?

The language for reviews content. IETF BCP 47 language code.

pagestring

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

rowsintegermultiple of 10[ 10 .. 100 ]

The maximum number of results to return per page.

Default 10

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/attractions/reviews \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "attraction": "PRTcWzDlwXjP",
    "language": "en-gb",
    "rows": 10
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

dataArray of objects(AttractionsReviewDataOutput)

metadataobject(MetadataOutput)

Metadata about the request.

Response

application/json

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    { … },
    { … }
  ],
  "metadata": {
    "next_page": "NextPageToken123",
    "total_results": 243
  }
}

Attraction review scores

Request

| 3.2 Beta | New |

Use this endpoint to retrieve detailed review scores for one or more specific attractions.

The response includes aggregated ratings across multiple categories (such as cleanliness, location, facilities, service, etc.) to give a deeper insight into traveller feedback.
Scores can be used to highlight strengths and weaknesses of an attraction or to create custom ranking and filtering logic.

Important: Ratings are based on all Booking.com traveller reviews and may not reflect your own users’ experiences. You are responsible for communicating the context of these scores if displayed.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

attractionsArray of strings= 1 itemsrequired

Uniquely identifies attractions to retrieve review scores for.

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/attractions/reviews/scores \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "attractions": [
      "PRTcWzDlwXjP"
    ]
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

dataArray of objects(AttractionScore)

Response

application/json

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    { … }
  ]
}

Orders

| 3.2 Beta | Changed |

Find in this version only the order endpoints that provide support to the car rental booking.

Use these endpoints to preview and create new car rental orders, check car order details, cancel or modify car rental orders.
This collection is required to integrate booking and order management functionality with car rental.

Important:

These endpoints are also available in version 3.2 but without the car implementation.
Support to car rental booking is only available in the 3.2 Beta version, as are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Messages

3.2 Beta

This API collection allows two-way post-booking communication between guests and properties and is currently available in the 3.2 Beta version.

Use these endpoints to test the complete communication flow, including sending and retrieving messages, conversations and attachments.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Conversations

Provides endpoints to retrieve and manage messaging conversations.

Use these endpoints to list conversations, fetch conversation details, and track updates.

Operations

Attachments

Provides endpoints for handling message attachments.

Use these endpoints to upload and download images shared within conversations.

Operations