# Booking.com stays · 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.

- Provider: Alexandria
- Category: Maps & Reviews
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `booking-com/hotels/search`
- Page: https://spiral.ai/tools/alexandria/booking-com/hotels/search

## Pricing

$0.00873 per call.

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `lang` | text |  | en-us | Booking.com language tag for translated text (en-us, en-gb, de, pt-br, ...). Pattern: ^[A-Za-z]{2}(-[A-Za-z]{2})?$. |
| `rows` | number | 1 to 50 | 25 | Rows per page (1-50); Booking.com may add sponsored rows. |
| `sort` | one 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'. |
| `query` | text |  | — | 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. |
| `rooms` | number | 1 to 30 | 1 | Number of rooms (1-30, at most one per adult). |
| `adults` | number | 1 to 30 | 2 | Number of adults (1-30). |
| `offset` | number | 0 to 1000 | 0 | Result offset; pass `next_offset` from the previous page. |
| `checkin` | text |  | — | Check-in date YYYY-MM-DD; defaults to 30 days from today. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `dest_id` | number |  | — | Destination id from `locations` (with `dest_type`). Either this or `query`. |
| `filters` | text |  | — | 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). |
| `checkout` | text |  | — | 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}$. |
| `currency` | text |  | USD | ISO 4217 display currency for prices (USD, EUR, GBP, ...). Pattern: ^[A-Za-z]{3}$. |
| `dest_type` | one of | city, region, district, landmark, airport, country, hotel | city | Kind of `dest_id`, as returned by `locations` (case-insensitive). |
| `country_code` | text |  | — | 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_ages` | list |  | — | Ages of the children travelling (0-17), one entry per child. |
| `include_filters` | true or false |  | — | Also return the filter facets (names, option ids and counts) for this search. |

## Example

```bash
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": {
      "lang": "en-us"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=booking-com%2Fhotels%2Fsearch

## Common questions

### Booking.com stays · Search

**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.

