# Booking.com Search

Fetches a Booking.com search results page and returns structured property cards (name, URL, image, review score, location, price). For best results pass checkin + checkout dates: bare location-only queries on Booking.com redirect to the empty form page.

- **Documentation:** [https://scrappa.co/docs/booking-api/booking_search](https://scrappa.co/docs/booking-api/booking_search)
- **API group:** Booking.com API
- **Endpoint:** `GET https://scrappa.co/api/booking/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ss` | string | Yes | Destination, e.g. "Paris" or "New York". |
| `checkin` | string | No | Check-in date (YYYY-MM-DD). Required for property cards to render. |
| `checkout` | string | No | Check-out date (YYYY-MM-DD). Required for property cards to render. |
| `group_adults` | integer | No | Number of adults (1-30). Defaults to Booking.com default. |
| `group_children` | integer | No | Number of children (0-20). |
| `no_rooms` | integer | No | Number of rooms (1-30). |
| `dest_id` | integer | No | Booking.com destination id when known (e.g. -1456928 for Paris). Helps Booking render resolved city result pages. |
| `dest_type` | string | No | Booking.com destination type when known: city, region, district, hotel, landmark, or airport. |
| `lang` | string | No | UI language hint (e.g. en-us, de). |
| `currency` | string | No | 3-letter currency code (e.g. EUR, USD). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/booking/search?ss=Paris&checkin=2026-06-01&checkout=2026-06-04&group_adults=2&dest_id=-1456928&dest_type=city"
```

## Example response

```json
{
    "data": {
        "results": []
    }
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)