Booking.com API

Booking.com things to do

Things to do in a destination: name, description, price, free cancellation, rating and review count, photo and the city.

Endpoint

GET/v1/booking/search-attractionslive · proven3 credits
Try in Playground

Parameters

Query parameters

NameRequiredDescriptionExample
locationnoA city; resolved to a destination once and remembered (or pass destination_id)Lisbon
destination_idnoA destination id from booking/attraction-locationseyJ1ZmkiOi0yMTY3OTczfQ==
pagenoPage number1
sortnotrending, attr_book_score or lowest_pricetrending
start_datenoFirst date, YYYY-MM-DD
end_datenoLast date, YYYY-MM-DD
currencynoThree-letter currency codeGBP
languagenoLanguage code for the site's text
typesnoThe site's type filters, separated by commas
labelsnoThe site's label filters, separated by commas
pricesnoThe site's price filters, separated by commas
areasnoThe site's area filters, separated by commas
dry_runnoRead a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution.1

Examples

Make the request

curl
curl "https://www.monocrawl.com/v1/booking/search-attractions" \
  -H "x-api-key: mn_your_key_here"
TypeScript
typescript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/booking/search-attractions",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);
Python
python
import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/booking/search-attractions",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

200 · application/json
{
  "success": true,
  "platform": "booking",
  "endpoint": "/v1/booking/search-attractions",
  "data": {
    "count": 0,
    "cursor": null,
    "destination": {
      "city": "example",
      "country": "example",
      "id": "example"
    },
    "has_more": false,
    "items": [
      {
        "city": "example",
        "country_code": "example",
        "description": "example",
        "destination_id": "example",
        "free_cancellation": false,
        "id": "example",
        "image_url": "https://example.com/example",
        "name": "example",
        "offers": 0,
        "platform": "example",
        "positive_share": "example",
        "price": {
          "amount": 0,
          "currency": "example"
        },
        "rating": 0,
        "ratings_count": 0,
        "reviews_count": 0,
        "slug": "example",
        "type": "example",
        "url": "https://example.com/example"
      }
    ],
    "page": 0,
    "total": 0
  },
  "credits_used": 3,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

Field inside dataTypeMeaning
countnumber | nullNumber of records in this response, not lifetime or total matches.
cursorstring | nullOpaque next-page token; pass it back unchanged. Null does not prove complete history.
destinationobject | nullOptional destination supplied by this operation. Null means unknown.
destination.citystring | nullOptional city supplied by this operation. Null means unknown.
destination.countrystring | nullOptional country supplied by this operation. Null means unknown.
destination.idstring | nullSource identifier. Preserve the supplied type and exact value.
has_moreboolean | nullSource continuation indicator; null means unknown.
itemsarray | nullReturned records. Source coverage and completeness vary.
items[].citystring | nullOptional city supplied by this operation. Null means unknown.
items[].country_codestring | nullOptional country code supplied by this operation. Null means unknown.
items[].descriptionstring | nullSource description; null or absent means not supplied.
items[].destination_idstring | nullOptional destination id supplied by this operation. Null means unknown.
items[].free_cancellationboolean | nullOptional free cancellation supplied by this operation. Null means unknown.
items[].idstring | nullSource identifier. Preserve the supplied type and exact value.
items[].image_urlstring | nullOptional image url supplied by this operation. Null means unknown.
items[].namestring | nullOptional name supplied by this operation. Null means unknown.
items[].offersnumber | nullOptional offers supplied by this operation. Null means unknown.
items[].platformstring | nullOptional platform supplied by this operation. Null means unknown.
items[].positive_sharestring | nullOptional positive share supplied by this operation. Null means unknown.
items[].priceobject | nullSource price. Currency, taxes and availability depend on the listing.
items[].price.amountnumber | nullOptional amount supplied by this operation. Null means unknown.
items[].price.currencystring | nullOptional currency supplied by this operation. Null means unknown.
items[].ratingnumber | nullSource rating; read its accompanying scale and vote count.
items[].ratings_countnumber | nullOptional ratings count supplied by this operation. Null means unknown.
items[].reviews_countnumber | nullOptional reviews count supplied by this operation. Null means unknown.
items[].slugstring | nullOptional slug supplied by this operation. Null means unknown.
items[].typestring | nullOptional type supplied by this operation. Null means unknown.
items[].urlstring | nullOriginal source URL when supplied.
pagenumber | nullOptional page supplied by this operation. Null means unknown.
totalnumber | nullSource-reported total; null is unknown.

Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.

The example is invented and illustrates types only; zero and empty values are not claims about a real result.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

First call in under a minute

1,000 monthly free credits and a ready-made key the moment you sign up. No card.