Docs menu

Booking API endpoint

Booking.com attractions search API

Returns Booking.com attractions/things-to-do search results for a destination and date range, with an optional category/subcategory filter and a discoverable category taxonomy.

GETapiKey5 credits/requestBookingbooking.bookingAttractionSearchResponseDoc/booking-attractions/search

Endpoint facts

Method: GET
API path: /booking-attractions/search
Auth: apiKey
Credits: 5 credits/request
Charged on: Successful 2xx responses only
Platform: Booking
Response schema: #/definitions/booking.bookingAttractionSearchResponseDoc

Booking.com Scraper API Try Booking.com attractions search API in Playground Booking API documentation

How this endpoint behaves

Query parameters

query (required): destination name or city, for example Paris.
start_date (required): availability start date, YYYY-MM-DD.
end_date: availability end date, YYYY-MM-DD. Defaults to start_date.
page: 1-based result page. Defaults to 1.
limit: results per page, 1-30. Defaults to 15.
category: optional top-level category tagname filter, from a prior response's categories[].tagname, for example PTCMCcodv3rh.
subcategory: optional subcategory tagname filter, from a prior response's categories[].subcategories[].tagname, for example PTCMCfzh93xC.

Response behavior

category/subcategory are opaque, destination-specific tagnames — not a small fixed enum — so they are passed through without an allowlist; an unrecognized value is rejected by Booking.com directly. data.categories[] lists every available category/subcategory (with names and product counts) for the resolved destination so a caller can discover a valid filter value without visiting Booking.com. data.filtered_count/data.unfiltered_count only differ when a category/subcategory filter is applied.

Live monitoring

Monitored request: GET /booking-attractions/search?query=Paris&start_date=2026-11-06
Checks passed, 7 days to 14 Oct 2026: 81.8%
Median response time: 2.38 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /booking-attractions/search?query=Paris&start_date=2026-10-27&limit=15
Items in products: 15
Fields filled in every checked item: 7
Fields empty in some or all items: 3

Field	Filled in, of 15 checked	Values in the sample
id	15
name	15	“Seine River Sightseeing Cruise” and 14 other values
slug	15
url	15	booking.com
description	15	“A one-hour boat tour through central Paris” and 14 other values
duration	11	“Duration: 1 hour - 1 hour 20 minutes” and 7 other values
price	15	13.41 to 121.61, median 21.23
currency	15	USD in all 15
review_score	14	3 to 4.6, median 4.3
review_count	14	2 to 7,280, median 1,201

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Destination name or city	Paris
start_date	string	Yes		Availability start date, YYYY-MM-DD	2026-09-15
end_date	string	No	start_date	Availability end date, YYYY-MM-DD, defaults to start_date	2026-09-15
page	integer	No		1-based result page, default 1	1
limit	integer	No		Results per page, 1-30, default 15	15
category	string	No		Optional top-level category tagname filter, from a prior response's categories	PTCMCcodv3rh
subcategory	string	No		Optional subcategory tagname filter, from a prior response's categories	PTCMCfzh93xC
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/booking-attractions/search?query=Paris&start_date=2026-09-15&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Paris",
    "destination": "Paris",
    "country": "fr",
    "page": 1,
    "has_next_page": true,
    "filtered_count": 751,
    "unfiltered_count": 2800,
    "categories": [
      {
        "name": "Museums, arts & culture",
        "tagname": "PTCMCcodv3rh",
        "product_count": 751,
        "subcategories": [
          {
            "name": "Cultural museums",
            "tagname": "PTCMCfzh93xC",
            "product_count": 471
          }
        ]
      }
    ],
    "products": [
      {
        "id": "PRe4kSVWXdrD",
        "name": "Seine River Sightseeing Cruise",
        "slug": "pre4ksvwxdrd-seine-river-sightseeing-cruise",
        "duration": "Duration: 1 hour",
        "price": 18,
        "currency": "EUR",
        "review_score": 8.6,
        "review_count": 4842
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/booking.bookingAttractionSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	booking.AttractionSearchResponse	No
data.categories	array	No
data.categories[].name	string	No
data.categories[].product_count	integer	No
data.categories[].subcategories	array	No
data.categories[].tagname	string	No
data.country	string	No
data.destination	string	No
data.filtered_count	integer	No
data.has_next_page	boolean	No
data.page	integer	No
data.products	array	No
data.products[].currency	string	No
data.products[].description	string	No
data.products[].duration	string	No
data.products[].id	string	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].review_count	integer	No
data.products[].review_score	number	No
data.products[].slug	string	No
data.products[].url	string	No
data.query	string	No
data.unfiltered_count	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/booking-attractions/search?query=Paris&start_date=2026-09-15&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Booking endpoint docs Booking.com Scraper API Booking.com attraction detail API documentation Booking.com attraction reviews API documentation Booking.com flight autocomplete API documentation Booking.com flight search API documentation Booking.com hotel detail API documentation Booking.com hotel reviews API documentation

Open in Playground Back to group

Docs menu

Booking API endpoint

Booking.com attractions search API

Returns Booking.com attractions/things-to-do search results for a destination and date range, with an optional category/subcategory filter and a discoverable category taxonomy.

GETapiKey5 credits/requestBookingbooking.bookingAttractionSearchResponseDoc/booking-attractions/search

Endpoint facts

Method: GET
API path: /booking-attractions/search
Auth: apiKey
Credits: 5 credits/request
Charged on: Successful 2xx responses only
Platform: Booking
Response schema: #/definitions/booking.bookingAttractionSearchResponseDoc

Booking.com Scraper API Try Booking.com attractions search API in Playground Booking API documentation

How this endpoint behaves

Query parameters

query (required): destination name or city, for example Paris.
start_date (required): availability start date, YYYY-MM-DD.
end_date: availability end date, YYYY-MM-DD. Defaults to start_date.
page: 1-based result page. Defaults to 1.
limit: results per page, 1-30. Defaults to 15.
category: optional top-level category tagname filter, from a prior response's categories[].tagname, for example PTCMCcodv3rh.
subcategory: optional subcategory tagname filter, from a prior response's categories[].subcategories[].tagname, for example PTCMCfzh93xC.

Response behavior

Live monitoring

Monitored request: GET /booking-attractions/search?query=Paris&start_date=2026-11-06
Checks passed, 7 days to 14 Oct 2026: 81.8%
Median response time: 2.38 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /booking-attractions/search?query=Paris&start_date=2026-10-27&limit=15
Items in products: 15
Fields filled in every checked item: 7
Fields empty in some or all items: 3

Field	Filled in, of 15 checked	Values in the sample
id	15
name	15	“Seine River Sightseeing Cruise” and 14 other values
slug	15
url	15	booking.com
description	15	“A one-hour boat tour through central Paris” and 14 other values
duration	11	“Duration: 1 hour - 1 hour 20 minutes” and 7 other values
price	15	13.41 to 121.61, median 21.23
currency	15	USD in all 15
review_score	14	3 to 4.6, median 4.3
review_count	14	2 to 7,280, median 1,201

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Destination name or city	Paris
start_date	string	Yes		Availability start date, YYYY-MM-DD	2026-09-15
end_date	string	No	start_date	Availability end date, YYYY-MM-DD, defaults to start_date	2026-09-15
page	integer	No		1-based result page, default 1	1
limit	integer	No		Results per page, 1-30, default 15	15
category	string	No		Optional top-level category tagname filter, from a prior response's categories	PTCMCcodv3rh
subcategory	string	No		Optional subcategory tagname filter, from a prior response's categories	PTCMCfzh93xC
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/booking-attractions/search?query=Paris&start_date=2026-09-15&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Paris",
    "destination": "Paris",
    "country": "fr",
    "page": 1,
    "has_next_page": true,
    "filtered_count": 751,
    "unfiltered_count": 2800,
    "categories": [
      {
        "name": "Museums, arts & culture",
        "tagname": "PTCMCcodv3rh",
        "product_count": 751,
        "subcategories": [
          {
            "name": "Cultural museums",
            "tagname": "PTCMCfzh93xC",
            "product_count": 471
          }
        ]
      }
    ],
    "products": [
      {
        "id": "PRe4kSVWXdrD",
        "name": "Seine River Sightseeing Cruise",
        "slug": "pre4ksvwxdrd-seine-river-sightseeing-cruise",
        "duration": "Duration: 1 hour",
        "price": 18,
        "currency": "EUR",
        "review_score": 8.6,
        "review_count": 4842
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/booking.bookingAttractionSearchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	booking.AttractionSearchResponse	No
data.categories	array	No
data.categories[].name	string	No
data.categories[].product_count	integer	No
data.categories[].subcategories	array	No
data.categories[].tagname	string	No
data.country	string	No
data.destination	string	No
data.filtered_count	integer	No
data.has_next_page	boolean	No
data.page	integer	No
data.products	array	No
data.products[].currency	string	No
data.products[].description	string	No
data.products[].duration	string	No
data.products[].id	string	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].review_count	integer	No
data.products[].review_score	number	No
data.products[].slug	string	No
data.products[].url	string	No
data.query	string	No
data.unfiltered_count	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/booking-attractions/search?query=Paris&start_date=2026-09-15&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Booking.com attractions search API

Endpoint facts

How this endpoint behaves

Query parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Booking.com attractions search API

Endpoint facts

How this endpoint behaves

Query parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related