# Booking.com Hotel Search Scraper (x402)

> Booking.com Hotel Search Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes Booking.com search results for hotel and property listings, returning structured data including names, types, stars, descriptions, and pricing for a given destination and date range.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/booking?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/booking-com-hotel-search-scraper-x402-b18b28c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wLJXsviWapGBHSvF7zhko

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability booking-com-hotel-search-scraper-x402-b18b28c1 -d '<json body>'
```

Example prompt: Search Booking.com for hotels in Barcelona for 2 adults, 1 room, checking in June 15 and checking out June 20, show me prices in USD, and return up to 50 properties.

## When to prefer this

Choose this endpoint when you need structured, machine-readable hotel listing data from Booking.com without maintaining your own scraper infrastructure. It is pay-per-call with no charge for failed or empty runs, making it cost-efficient for exploratory searches. Prefer it over generic web scrapers when you specifically need Booking.com property data with structured fields like star ratings, property IDs, and typed accommodation categories. Best suited for travel agents, comparison tools, or itinerary planners that need to programmatically query accommodation availability across a destination.

## Known failure modes

- Booking.com presents a CAPTCHA or verification challenge on the search page, resulting in an empty or failed response (not charged)
- Invalid or unrecognized destination name returns empty results
- Check-out date before or equal to check-in date may cause an error or empty response
- Invalid currency code may fall back to default or cause a failed run
- Exceeding maximum room or adult limits (50) causes a validation error
- Provided startUrls point to non-Booking.com or private pages, resulting in empty output

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of property items. Each item includes the property name, URL, type, star rating, property ID, property type ID, description, and listing order position. Failed or empty scrape runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rooms": {
   "type": "integer",
   "default": 1,
   "maximum": 50,
   "minimum": 1,
   "description": "Number of rooms for search-result availability and pricing."
  },
  "adults": {
   "type": "integer",
   "default": 2,
   "maximum": 50,
   "minimum": 1,
   "description": "Number of adults for search-result availability and pricing."
  },
  "search": {
   "type": "string",
   "description": "Destination name for a Booking.com search. For example, Amsterdam. Search pages may present a verification challenge."
  },
  "checkIn": {
   "type": "string",
   "description": "Check-in date (YYYY-MM-DD) for search results and dated prices. Set checkOut too."
  },
  "checkOut": {
   "type": "string",
   "description": "Check-out date (YYYY-MM-DD) after checkIn."
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "description": "Preferred three-letter currency code for displayed prices."
  },
  "language": {
   "type": "string",
   "default": "en-us",
   "description": "Booking.com language code for labels, such as en-us or fr."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum number of unique properties across all inputs. Set 0 for all available public results."
  },
  "startUrls": {
   "type": "array",
   "description": "Public Booking.com search-results or city URLs. Search URLs can contain website filters. City URLs offer a smaller, more reliable set of listings."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "name": null,
    "type": null,
    "order": null,
    "stars": null,
    "propertyId": null,
    "description": null,
    "propertyTypeId": null
   }
  ],
  "product": "booking"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/booking-com-hotel-search-scraper-x402-b18b28c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)