Booking.com API
Booking.com flight search
Flights between two places: each offer's price with its base fare and tax, seats left, and every segment and leg with airports, times, carrier, flight number, cabin and luggage allowance; plus the search's summary (cheapest fare, airlines, stops).
Endpoint
GET/v1/booking/search-flightslive · proven3 creditsParameters
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
from | yes | Departure place code from booking/flight-locations | LON.CITY |
to | yes | Arrival place code from booking/flight-locations | LIS.AIRPORT |
depart_date | yes | Outbound date, YYYY-MM-DD | 2026-11-25 |
return_date | no | Return date, YYYY-MM-DD, for a round trip | |
adults | no | Adults, 1 to 9 | 1 |
children_ages | no | Children's ages, separated by commas | |
cabin | no | economy, premium_economy, business or first | economy |
sort | no | best, cheapest or fastest | best |
stops | no | none, 0, 1 or 2 | |
page | no | Page number | 1 |
currency | no | Three-letter currency code | GBP |
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. | 1 |
Examples
Make the request
curl
curl "https://www.monocrawl.com/v1/booking/search-flights?from=LON.CITY&to=LIS.AIRPORT&depart_date=2026-11-25" \ -H "x-api-key: mn_your_key_here"
TypeScript
typescript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
"https://www.monocrawl.com/v1/booking/search-flights?from=LON.CITY&to=LIS.AIRPORT&depart_date=2026-11-25",
{ headers: { "x-api-key": key } },
);
const body = await res.json();
if (!body.success) {
// one error shape for every endpoint — see /docs/errors
throw new Error(`${body.error.type}: ${body.error.message}`);
}
console.log(body.data, "credits left:", body.credits_remaining);Python
python
import os
import requests
res = requests.get(
"https://www.monocrawl.com/v1/booking/search-flights?from=LON.CITY&to=LIS.AIRPORT&depart_date=2026-11-25",
headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
timeout=60,
)
body = res.json()
if not body["success"]:
# one error shape for every endpoint — see /docs/errors
raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")
print(body["data"], "credits left:", body["credits_remaining"])Response
Response fields and example
This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.
200 · application/json
{
"success": true,
"platform": "booking",
"endpoint": "/v1/booking/search-flights",
"data": {
"adults": 0,
"atol_protected": "example",
"count": 0,
"cursor": null,
"depart_date": "2026-09-01T12:00:00Z",
"from": "example",
"has_more": false,
"items": [
{
"base_fare": {
"amount": 0,
"currency": "example"
},
"carriers": [
{}
],
"discount": {
"amount": 0,
"currency": "example"
},
"fee": {
"amount": 0,
"currency": "example"
},
"platform": "example",
"point_of_sale": "example",
"price": {
"amount": 0,
"currency": "example"
},
"price_rounded": {
"amount": 0,
"currency": "example"
},
"segments": [
{}
],
"tax": {
"amount": 0,
"currency": "example"
},
"token": "example",
"trip_type": "example",
"type": "example"
}
],
"page": 0,
"summary": {
"airlines": [
{
"code": "example",
"count": 0,
"logo_url": "https://example.com/example",
"min_price": {},
"name": "example"
}
],
"duration_hours": {
"max": 0,
"min": 0
},
"min_price": {
"amount": 0,
"currency": "example"
},
"stops": [
{
"count": 0,
"min_price": {},
"stops": 0
}
]
},
"to": "example",
"total": 0
},
"credits_used": 3,
"credits_remaining": 99,
"request_id": "req_…",
"cached": false
}The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.
Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.
Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.
| Field inside data | Type | Meaning |
|---|---|---|
adults | number | null | Optional adults supplied by this operation. Null means unknown. |
atol_protected | string | null | Optional atol protected supplied by this operation. Null means unknown. |
count | number | null | Number of records in this response, not lifetime or total matches. |
cursor | string | null | Opaque next-page token; pass it back unchanged. Null does not prove complete history. |
depart_date | string | null | Optional depart date supplied by this operation. Null means unknown. |
from | string | null | Optional from supplied by this operation. Null means unknown. |
has_more | boolean | null | Source continuation indicator; null means unknown. |
items | array | null | Returned records. Source coverage and completeness vary. |
items[].base_fare | object | null | Optional base fare supplied by this operation. Null means unknown. |
items[].base_fare.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].base_fare.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].carriers | array | null | Optional carriers supplied by this operation. Null means unknown. |
items[].discount | object | null | Optional discount supplied by this operation. Null means unknown. |
items[].discount.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].discount.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].fee | object | null | Optional fee supplied by this operation. Null means unknown. |
items[].fee.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].fee.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].platform | string | null | Optional platform supplied by this operation. Null means unknown. |
items[].point_of_sale | string | null | Optional point of sale supplied by this operation. Null means unknown. |
items[].price | object | null | Source price. Currency, taxes and availability depend on the listing. |
items[].price.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].price.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].price_rounded | object | null | Optional price rounded supplied by this operation. Null means unknown. |
items[].price_rounded.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].price_rounded.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].segments | array | null | Optional segments supplied by this operation. Null means unknown. |
items[].tax | object | null | Optional tax supplied by this operation. Null means unknown. |
items[].tax.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
items[].tax.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
items[].token | string | null | Optional token supplied by this operation. Null means unknown. |
items[].trip_type | string | null | Optional trip type supplied by this operation. Null means unknown. |
items[].type | string | null | Optional type supplied by this operation. Null means unknown. |
page | number | null | Optional page supplied by this operation. Null means unknown. |
summary | object | null | Optional summary supplied by this operation. Null means unknown. |
summary.airlines | array | null | Optional airlines supplied by this operation. Null means unknown. |
summary.airlines[].code | string | null | Optional code supplied by this operation. Null means unknown. |
summary.airlines[].count | number | null | Number of records in this response, not lifetime or total matches. |
summary.airlines[].logo_url | string | null | Optional logo url supplied by this operation. Null means unknown. |
summary.airlines[].min_price | object | null | Optional min price supplied by this operation. Null means unknown. |
summary.airlines[].name | string | null | Optional name supplied by this operation. Null means unknown. |
summary.duration_hours | object | null | Optional duration hours supplied by this operation. Null means unknown. |
summary.duration_hours.max | number | null | Optional max supplied by this operation. Null means unknown. |
summary.duration_hours.min | number | null | Optional min supplied by this operation. Null means unknown. |
summary.min_price | object | null | Optional min price supplied by this operation. Null means unknown. |
summary.min_price.amount | number | null | Optional amount supplied by this operation. Null means unknown. |
summary.min_price.currency | string | null | Optional currency supplied by this operation. Null means unknown. |
summary.stops | array | null | Optional stops supplied by this operation. Null means unknown. |
summary.stops[].count | number | null | Number of records in this response, not lifetime or total matches. |
summary.stops[].min_price | object | null | Optional min price supplied by this operation. Null means unknown. |
summary.stops[].stops | number | null | Optional stops supplied by this operation. Null means unknown. |
to | string | null | Optional to supplied by this operation. Null means unknown. |
total | number | null | Source-reported total; null is unknown. |
Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.
The example is invented and illustrates types only; zero and empty values are not claims about a real result.
Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference