# Booking.com Prices

Returns visible price text from dated Booking.com search result cards. This is a public-page signal, not guaranteed inventory.

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

## 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 | Yes | Check-in date (YYYY-MM-DD). Required for price cards to render. |
| `checkout` | string | Yes | Check-out date (YYYY-MM-DD). Required for price 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/prices?ss=Paris&checkin=2026-06-01&checkout=2026-06-04&group_adults=2&dest_id=-1456928&dest_type=city"
```

## Example response

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

## 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)
