[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Booking.com hotel search](https://spiral.ai/integrations/codex/booking-com-hotel-search)

# How to Use Booking.com hotel search in Codex

Returns accommodation options matching a destination and stay dates. Use it to build a shortlist, then inspect individual properties and check their availability.

|  |  |
| --- | --- |
| Model | Booking.com hotel search |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Booking.com hotel search in Codex

- Use Booking.com hotel search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Booking.com hotel search and tell me what changed since last week.
- Check Booking.com hotel search and summarize what you find in three bullet points.
- Pull the newest data from Booking.com hotel search and give me the result as a table.
- Check Booking.com hotel search every morning and tell me only when something changed.

## How to set up Booking.com hotel search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Booking.com hotel search**: One request; the result comes back by polling or a webhook.

```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": {
      "dest_id": 1
    }
  }'
```

Then paste one of the prompts above: Codex finds Booking.com hotel search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Booking.com hotel search tools and prices

- [Booking.com stays · Search](https://spiral.ai/tools/alexandria/booking-com/hotels/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| lang |  | 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 | 1 to 50 | 25 | Rows per page (1-50); Booking.com may add sponsored rows. |
| sort | 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 |  | — | 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 | 1 to 30 | 1 | Number of rooms (1-30, at most one per adult). |
| adults | 1 to 30 | 2 | Number of adults (1-30). |

## What can you do with Booking.com hotel search in Codex?

Build a hotel comparison view that keeps property information, dated stays, guest feedback, and surrounding places distinct. Use destination matches to anchor each comparison to the intended Booking.com location.

### Prepare a conference hotel shortlist

Resolve the conference destination, find stays for the event dates, and compare property facilities, availability, guest feedback, and nearby places in one decision brief.

### Compare bases for a city break

Resolve the intended city or district, shortlist accommodation, and weigh property details and available stays against guest feedback and the surrounding area.

### Research an airport overnight stay

Identify the correct airport destination and compare accommodation for an overnight stop. Bring together property policies, availability, reviews, and nearby-place context before choosing a shortlist.

### Plan accommodation across several stops

Resolve each destination on a rail itinerary and create a stay brief for every stop. Compare available properties, facilities, policies, guest feedback, and surroundings for the dates at each destination.

### Resolve ambiguous destination names

Inspect destination suggestions before searching for accommodation in places such as Cambridge. Keep the intended location explicit throughout the shortlist.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Booking.com hotel search in other agents

- [Amp](https://spiral.ai/integrations/amp/booking-com-hotel-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/booking-com-hotel-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/booking-com-hotel-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/booking-com-hotel-search)
- [Cline](https://spiral.ai/integrations/cline/booking-com-hotel-search)
- [Cursor](https://spiral.ai/integrations/cursor/booking-com-hotel-search)
- [Devin](https://spiral.ai/integrations/devin/booking-com-hotel-search)
- [dots](https://spiral.ai/integrations/dots/booking-com-hotel-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/booking-com-hotel-search)
- [Gemini](https://spiral.ai/integrations/gemini/booking-com-hotel-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/booking-com-hotel-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/booking-com-hotel-search)
- [goose](https://spiral.ai/integrations/goose/booking-com-hotel-search)
- [Grok](https://spiral.ai/integrations/grok/booking-com-hotel-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/booking-com-hotel-search)
- [Hermes](https://spiral.ai/integrations/hermes/booking-com-hotel-search)
- [Instinct](https://spiral.ai/integrations/instinct/booking-com-hotel-search)
- [Manus](https://spiral.ai/integrations/manus/booking-com-hotel-search)
- [Muse](https://spiral.ai/integrations/muse/booking-com-hotel-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/booking-com-hotel-search)
- [n8n](https://spiral.ai/integrations/n8n/booking-com-hotel-search)
- [Notion](https://spiral.ai/integrations/notion/booking-com-hotel-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/booking-com-hotel-search)
- [opencode](https://spiral.ai/integrations/opencode/booking-com-hotel-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/booking-com-hotel-search)
- [Raycast](https://spiral.ai/integrations/raycast/booking-com-hotel-search)
- [VS Code](https://spiral.ai/integrations/vscode/booking-com-hotel-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/booking-com-hotel-search)
- [Zapier](https://spiral.ai/integrations/zapier/booking-com-hotel-search)

## More Codex guides

- [Booking.com hotel reviews](https://spiral.ai/integrations/codex/booking-com-hotel-reviews)
- [Booking.com hotel surroundings](https://spiral.ai/integrations/codex/booking-com-hotel-surroundings)
- [Booking.com hotel details](https://spiral.ai/integrations/codex/booking-com-hotel-details)
- [Campspot campground details](https://spiral.ai/integrations/codex/campspot-campground-details)
- [Booking.com hotel availability](https://spiral.ai/integrations/codex/booking-com-hotel-availability)
- [Campspot campground directory](https://spiral.ai/integrations/codex/campspot-campground-directory)

## Questions about Booking.com hotel search in Codex

**Can Codex use Booking.com hotel search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Booking.com hotel search like any built-in tool.

**How much does Booking.com hotel search cost in Codex?**

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

**Do I need an Alexandria account to use Booking.com hotel search in Codex?**

No. Spiral runs Booking.com hotel search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Booking.com hotel search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Booking.com hotel search runs?**

Booking.com hotel search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does Booking.com include every hotel in a destination?**

No. Booking.com only shows accommodations that have a commercial relationship with it, so results do not represent every hotel or rental in the area.

**Where do Booking.com's property descriptions come from?**

Booking.com bases accommodation information on what service providers supply. That includes the property information used to assess a hotel's facilities and location.

**How quickly do property details update?**

Booking.com says descriptions and facility lists can take a few hours to update. A recently changed amenity may therefore take time to appear.

**How much review history remains visible?**

Booking.com may stop showing reviews once they are 36 months old. The visible reviews should not be treated as a permanent archive of a property's feedback.

**What scale does Booking.com use for guest scores?**

Guest review scores run from 1 to 10. These scores represent property feedback, separate from the property's descriptive information.

