## booking/search-hotels

`GET /v1/booking/search-hotels`

Hotels in a destination for a stay: name, stars, review score and count, the price for the stay, check-in and check-out times, position, photos and whether the site prefers it.

*Booking.com hotel search*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | no | A city, district, landmark or hotel name; resolved to a destination once and remembered (or pass destination_id and destination_type) — e.g. `Lisbon` |
| `destination_id` | no | A destination id from booking/locations — e.g. `-2167973` |
| `destination_type` | no | The destination's type from booking/locations — e.g. `CITY` |
| `checkin` | yes | Check-in date, YYYY-MM-DD — e.g. `2026-10-10` |
| `checkout` | yes | Check-out date, YYYY-MM-DD — e.g. `2026-10-12` |
| `adults` | no | Adults, 1 to 30 — e.g. `2` |
| `children_ages` | no | Children's ages, separated by commas |
| `rooms` | no | Rooms, 1 to 30 — e.g. `1` |
| `page` | no | Page number — e.g. `1` |
| `sort` | no | popularity, price, class, review_score or distance Accepted values: popularity, price, class, review_score, distance, upsort_bh, class_asc, class_desc, bayesian_review_score. Case, spaces, hyphens and underscores are interchangeable. |
| `min_price` | no | Minimum price per night in the currency |
| `max_price` | no | Maximum price per night in the currency |
| `filters` | no | The site's category filters, separated by commas (class::4, free_cancellation::1…) |
| `currency` | no | Three-letter currency code — e.g. `GBP` |
| `language` | no | Language code for the site's text — e.g. `en-gb` |
| `units` | no | metric or imperial Accepted values: metric, imperial. Case, spaces, hyphens and underscores are interchangeable. |
| `temperature_unit` | no | c or f Accepted values: c, f. Case, spaces, hyphens and underscores are interchangeable. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/booking/search-hotels?checkin=2026-10-10&checkout=2026-10-12" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "adults": 0,
  "checkin": "example",
  "checkout": "example",
  "count": 0,
  "cursor": null,
  "destination": {
    "id": "example",
    "label": "example",
    "name": "example",
    "type": "example"
  },
  "has_more": false,
  "items": [
    {
      "accurate_class": 0,
      "badges": [
        "example"
      ],
      "checkin": {
        "from": "example",
        "until": "example"
      },
      "checkin_date": "2026-09-01T12:00:00Z",
      "checkout": {
        "from": "example",
        "until": "example"
      },
      "checkout_date": "2026-09-01T12:00:00Z",
      "country_code": "example",
      "currency": "example",
      "destination_id": "example",
      "id": "example",
      "image_url": "https://example.com/example",
      "images": [
        "example"
      ],
      "label": "example",
      "latitude": 0,
      "longitude": 0,
      "name": "example",
      "platform": "example",
      "position": 0,
      "preferred": false,
      "price": {
        "amount": 0,
        "currency": "example"
      },
      "rank": 0,
      "review_count": 0,
      "review_score": 0,
      "review_score_word": "example",
      "stars": 0,
      "strikethrough_price": {
        "amount": 0,
        "currency": "example"
      },
      "type": "example"
    }
  ],
  "page": 0,
  "rooms": 0,
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/booking/search-hotels#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/booking/search-hotels.json)