Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaMaps & ReviewsAvailable now

Booking.com stays · Search

booking-com/hotels/search

Get places and reviews from maps with Booking.com stays · Search from Alexandria through one Spiral API key. Compare accommodation for given dates in a city, district, region, landmark or airport area (dest_id from locations), or by free-text query; then call hotel, availability or reviews with the ids returned. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
langtexten-us

Booking.com language tag for translated text (en-us, en-gb, de, pt-br, ...). Pattern: ^[A-Za-z]{2}(-[A-Za-z]{2})?$.

rowsnumber
1 to 50
25

Rows per page (1-50); Booking.com may add sponsored rows.

sortone of
popularity, upsort_bh, price, price_from_high_to_low, review_score_and_price, class, class_asc, class_and_price, distance_from_search, bayesian_review_score
popularity

Booking.com sorter; popularity is 'Our top picks'.

querytext—

Free-text destination or property name instead of dest_id: resolved to the first locations suggestion whose name matches it (else the first suggestion), and the record reports the resolved dest_id, dest_type, name_match and matched_hotel_id. A property match resolves to dest_type HOTEL: that property first, then others in its region. A query naming a property and its city ("River Inn Hotel Tashkent") that Booking.com answers with the city only is looked up again without the city, within the city's country. When the chosen suggestion is a third-party place (Google, HERE) the search is scoped to its coordinates and reports dest_type LATLONG, properties nearest first. Pass country_code to rule out same-name places in other countries. For properties around a place, pick the LANDMARK/CITY/DISTRICT dest_id from locations instead.

roomsnumber
1 to 30
1

Number of rooms (1-30, at most one per adult).

adultsnumber
1 to 30
2

Number of adults (1-30).

offsetnumber
0 to 1000
0

Result offset; pass next_offset from the previous page.

checkintext—

Check-in date YYYY-MM-DD; defaults to 30 days from today. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

dest_idnumber—

Destination id from locations (with dest_type). Either this or query.

filterstext—

Semicolon-joined Booking.com filter tokens (facet option ids from include_filters), e.g. review_score=80;ht_id=204;fc=2. Booking.com also accepts tokens its facet list does not enumerate: hotelfacility=<id> for any property facility id from hotel.facilities (72 BBQ facilities), roomfacility=45 (kitchen), distance=<meters> from the destination centre (distance=10000 for 10 km).

checkouttext—

Check-out date YYYY-MM-DD; defaults to one night after check-in. At most 90 nights. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

currencytextUSD

ISO 4217 display currency for prices (USD, EUR, GBP, ...). Pattern: ^[A-Za-z]{3}$.

dest_typeone of
city, region, district, landmark, airport, country, hotel
city

Kind of dest_id, as returned by locations (case-insensitive).

country_codetext—

ISO 3166-1 alpha-2 country the free-text query must resolve in (cz, uz, us). Only Booking.com destinations in that country are considered; third-party places are skipped because their country is not reliable. No such destination: not_found. Only with query. Pattern: ^[A-Za-z]{2}$.

children_ageslist—

Ages of the children travelling (0-17), one entry per child.

include_filterstrue or false—

Also return the filter facets (names, option ids and counts) for this search.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "booking-com/hotels/search",
    "input": {
      "dest_id": 1
    }
  }'

Frequently asked questions

How much does Booking.com stays · Search cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Booking.com stays · Search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "booking-com/hotels/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Booking.com stays · Search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Booking.com stays · Search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.