Skip to content
API REFERENCES/
/Attractions

Search attractions

Request

Use this endpoint to search for attractions based on a single search criterion, such as attraction IDs, cities, countries, or geographic coordinates.

Security
BearerAuth
Headers
X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json
One of:
attractionsArray of strings, [ 1 .. 100 ]required

List of attraction IDs to search for. When provided, results are limited to these specific attractions.

citiesany
coordinatesany
countriesany
currencystring(pricing_currencyId)[A-Z]{3}required

A three-letter ISO 4217 currency code that defines the currency used for pricing in the response, for example: EUR or USD. n/See common/payments/currencies for the full list of supported currencies.

datesobject(datesInput)required

Date range used to search for attraction availability.

filtersobject(filtersInput)

Optional filters to narrow down attraction search results.

pagestring

Pagination token used to retrieve the next page of results. Omit this parameter on the first request and use the value returned in metadata.next_page for subsequent pages.

rowsinteger, multiple of 10, [ 10 .. 100 ](maximumResults)

The maximum number of results to return.

Default:20
sortobject(sort)

Sorting options that control the order of the search results.

curl -i -X POST \
  https://demandapi.booking.com/3.2/attractions/search \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "currency": "EUR",
    "attractions": [
      "PR0dwCIbnsiU",
      "AFd2wcIjMauX"
    ],
    "dates": {
      "start_date": "2026-09-18",
      "end_date": "2026-09-20"
    },
    "rows": 50,
    "sort": {
      "by": "most_popular"
    }
  }'

Responses

Successful response.

Bodyapplication/json
dataArray of objects(attraction)
metadataobject(MetadataOutput)

Metadata about the request.

request_idstring(requestId)

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

Response
{
  "data": [
    { … },
    { … },
    { … }
  ],
  "metadata": {
    "next_page": "eyJhbGciOiJIUzI1NiJ9.eyJwIjp7ImN1cnJlbmN5IjoiRVVSIiwicXVlcnkiOnsiY291bnRyaWVzIjpbIm5sIiwiZnIiXSwiY29vcmRpbmF0ZXMiOnsibGF0aXR1ZGUiOjUyLjM3LCJsb25naXR1ZGUiOjQuOTAsIm1heF9kaXN0YW5jZV9rbSI6MTAwLjAwfSwic3RhcnRfZGF0ZSI6IjIwMjUtMDktMjEiLCJlbmRfZGF0ZSI6IjIwMjUtMDktMjIiLCJzdXBwb3J0ZWRfbGFuZ3VhZ2VzIjpbIm5sIl0sIm1pbl9yYXRpbmciOjQuMDAsIm1pbl9yZXZpZXdfY291bnQiOjV9LCJvcmRlcl9ieSI6Im1hdGNoX3Njb3JlIiwicGFnZV9udW1iZXIiOjJ9LCJhdWQiOiIvYXR0cmFjdGlvbnMvc2VhcmNoIiwiZXhwIjoxNzU3Mzc0MzI0fQ.JUU7kbuwiCaS4n_SZANA577BvZWdqDDQizU8q6fTrg0",
    "total_results": 128
  },
  "request_id": "01fr9ez700exycb98w90w5r9sh"
}