---
title: "Scrape Booking.com hotels"
method: POST
path: "/travel/booking"
tags: ["Plugins"]
---

# Scrape Booking.com hotels

`POST /travel/booking`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/travel/booking`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Booking.com for `location` and returns the properties as JSON: `name`, `price` (with `checkin`/`checkout`), `reviewScore`, `address`, coordinates, `image` and a hotel `url`. Set `adults`, `children`, `rooms` and `currency`, and collect up to `max_results` across pages. Prices only appear when check-in/check-out dates are given.

## Query parameters

- `location` string, required: City or place to search, e.g. 'Austin' or 'Paris'.
- `checkin` string, nullable: Check-in YYYY-MM-DD (needed for prices).
- `checkout` string, nullable: Check-out YYYY-MM-DD.
- `adults` integer, nullable: Number of adults.
- `children` integer, nullable: Number of children.
- `rooms` integer, nullable: Number of rooms.
- `currency` string: Price currency: USD, EUR, GBP, AUD, CAD, CHF, JPY, CNY, INR, BRL, MXN, PLN, SEK, NOK, DKK, AED, SGD, ZAR, TRY, RUB.
- `max_results` integer: How many properties to collect across pages.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').

## Response `200`

JSON with a `properties` array.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Booking, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)
