BrowsableBooking.com APIs
Booking.com Hotel API
Scrape hotel details and dated room offers with occupancy, cancellation, meals, payment and tax text. Supply checkin, checkout, group_adults, group_children, no_rooms and selected_currency in the URL. Displayed prices may exclude taxes. Returns public discovery metadata; undated prices are not stay-specific quotes. This endpoint does not accept stay dates or occupancy; check a dated search on the source website for stay-specific prices.
POST
/v1/booking/hotelSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
urlstringRequiredURL returned by the matching search endpoint. Minimum length: 1. Maximum length: 2000.
Response
Every response describes a run. Read result once run_status is succeeded.
run_id- The run to track. Keep it when contacting support.
run_status- Queued, running, waiting for sign-in, succeeded, or failed. Check this even after an HTTP 200.
status_url- Poll this URL while the run is pending. Keep the same run instead of starting another request.
result- The endpoint’s returned data. The example is illustrative; actual fields may be empty or unavailable.
error- On failure, inspect its code, message, retryable and action fields.
View the complete output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"success",
"source",
"query",
"url",
"results",
"count",
"data",
"max_results_requested",
"pagination"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data": {
"type": "object",
"properties": {
"price": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"price_basis": {
"type": [
"string",
"null"
]
},
"price_value": {
"type": [
"number",
"null"
]
},
"room_offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"beds": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"string",
"null"
]
},
"taxes": {
"type": [
"string",
"null"
]
},
"nights": {
"type": [
"number",
"null"
]
},
"payment": {
"type": [
"string",
"null"
]
},
"room_id": {
"type": [
"string",
"null"
]
},
"capacity": {
"type": [
"number",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"breakfast": {
"type": [
"string",
"null"
]
},
"meal_plan": {
"type": [
"string",
"null"
]
},
"occupancy": {
"type": [
"string",
"null"
]
},
"room_name": {
"type": [
"string",
"null"
]
},
"conditions": {
"type": [
"string",
"null"
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"tax_status": {
"type": [
"string",
"null"
]
},
"price_basis": {
"type": [
"string",
"null"
]
},
"cancellation": {
"type": [
"string",
"null"
]
},
"quote_source": {
"type": [
"string",
"null"
]
},
"room_details": {
"type": [
"object",
"null"
],
"properties": {
"source": {
"type": "string"
},
"room_id": {
"type": "string"
},
"capacity": {
"type": [
"number",
"null"
]
},
"facilities": {
"type": "array",
"items": {
"type": "object"
}
},
"descriptions": {},
"room_area_m2": {
"type": [
"number",
"null"
]
},
"bed_configurations": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"source_total": {
"type": [
"number",
"null"
]
},
"quote_room_id": {
"type": [
"string",
"null"
]
},
"room_features": {
"type": "array",
"items": {
"type": "string"
}
},
"hotel_currency": {
"type": [
"string",
"null"
]
},
"policy_details": {
"type": [
"string",
"null"
]
},
"quote_complete": {
"type": "boolean"
},
"quote_currency": {
"type": [
"string",
"null"
]
},
"rate_is_genius": {
"type": "boolean"
},
"tax_exceptions": {
"type": "array",
"items": {}
},
"displayed_total": {
"type": [
"number",
"null"
]
},
"quote_room_name": {
"type": [
"string",
"null"
]
},
"source_capacity": {
"type": [
"number",
"null"
]
},
"source_subtotal": {
"type": [
"number",
"null"
]
},
"excluded_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"included_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"optional_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"breakfast_included": {
"type": [
"boolean",
"null"
]
},
"source_hotel_total": {
"type": [
"number",
"null"
]
},
"conditional_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"max_selectable_rooms": {
"type": [
"number",
"null"
]
},
"source_payment_terms": {
"type": "object"
},
"source_hotel_subtotal": {
"type": [
"number",
"null"
]
},
"total_including_taxes": {
"type": [
"number",
"null"
]
},
"matches_requested_stay": {
"type": [
"boolean",
"null"
]
},
"observed_stay_verified": {
"type": "boolean"
},
"matches_requested_occupancy": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": true
}
},
"observed_stay": {
"type": "object",
"properties": {
"checkin": {
"type": [
"string",
"null"
]
},
"checkout": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"offers_status": {
"type": [
"string",
"null"
]
},
"price_offer_id": {
"type": [
"string",
"null"
]
},
"requested_stay": {
"type": "object",
"properties": {
"rooms": {
"type": [
"number",
"null"
]
},
"adults": {
"type": [
"number",
"null"
]
},
"nights": {
"type": [
"number",
"null"
]
},
"checkin": {
"type": [
"string",
"null"
]
},
"checkout": {
"type": [
"string",
"null"
]
},
"children": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"room_details_status": {
"type": [
"string",
"null"
]
},
"quote_display_currency": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"count": {
"type": "integer"
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"price": {
"type": [
"string",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"price_basis": {
"type": [
"string",
"null"
]
},
"price_value": {
"type": [
"number",
"null"
]
},
"room_offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"beds": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"string",
"null"
]
},
"taxes": {
"type": [
"string",
"null"
]
},
"nights": {
"type": [
"number",
"null"
]
},
"payment": {
"type": [
"string",
"null"
]
},
"room_id": {
"type": [
"string",
"null"
]
},
"capacity": {
"type": [
"number",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"breakfast": {
"type": [
"string",
"null"
]
},
"meal_plan": {
"type": [
"string",
"null"
]
},
"occupancy": {
"type": [
"string",
"null"
]
},
"room_name": {
"type": [
"string",
"null"
]
},
"conditions": {
"type": [
"string",
"null"
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"tax_status": {
"type": [
"string",
"null"
]
},
"price_basis": {
"type": [
"string",
"null"
]
},
"cancellation": {
"type": [
"string",
"null"
]
},
"quote_source": {
"type": [
"string",
"null"
]
},
"room_details": {
"type": [
"object",
"null"
],
"properties": {
"source": {
"type": "string"
},
"room_id": {
"type": "string"
},
"capacity": {
"type": [
"number",
"null"
]
},
"facilities": {
"type": "array",
"items": {
"type": "object"
}
},
"descriptions": {},
"room_area_m2": {
"type": [
"number",
"null"
]
},
"bed_configurations": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"source_total": {
"type": [
"number",
"null"
]
},
"quote_room_id": {
"type": [
"string",
"null"
]
},
"room_features": {
"type": "array",
"items": {
"type": "string"
}
},
"hotel_currency": {
"type": [
"string",
"null"
]
},
"policy_details": {
"type": [
"string",
"null"
]
},
"quote_complete": {
"type": "boolean"
},
"quote_currency": {
"type": [
"string",
"null"
]
},
"rate_is_genius": {
"type": "boolean"
},
"tax_exceptions": {
"type": "array",
"items": {}
},
"displayed_total": {
"type": [
"number",
"null"
]
},
"quote_room_name": {
"type": [
"string",
"null"
]
},
"source_capacity": {
"type": [
"number",
"null"
]
},
"source_subtotal": {
"type": [
"number",
"null"
]
},
"excluded_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"included_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"optional_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"breakfast_included": {
"type": [
"boolean",
"null"
]
},
"source_hotel_total": {
"type": [
"number",
"null"
]
},
"conditional_charges": {
"type": "array",
"items": {
"type": "object"
}
},
"max_selectable_rooms": {
"type": [
"number",
"null"
]
},
"source_payment_terms": {
"type": "object"
},
"source_hotel_subtotal": {
"type": [
"number",
"null"
]
},
"total_including_taxes": {
"type": [
"number",
"null"
]
},
"matches_requested_stay": {
"type": [
"boolean",
"null"
]
},
"observed_stay_verified": {
"type": "boolean"
},
"matches_requested_occupancy": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": true
}
},
"observed_stay": {
"type": "object",
"properties": {
"checkin": {
"type": [
"string",
"null"
]
},
"checkout": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"offers_status": {
"type": [
"string",
"null"
]
},
"price_offer_id": {
"type": [
"string",
"null"
]
},
"requested_stay": {
"type": "object",
"properties": {
"rooms": {
"type": [
"number",
"null"
]
},
"adults": {
"type": [
"number",
"null"
]
},
"nights": {
"type": [
"number",
"null"
]
},
"checkin": {
"type": [
"string",
"null"
]
},
"checkout": {
"type": [
"string",
"null"
]
},
"children": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"room_details_status": {
"type": [
"string",
"null"
]
},
"quote_display_currency": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
},
"success": {
"const": true
},
"pagination": {
"type": "object",
"required": [
"cursor",
"next_cursor",
"has_next_page",
"count",
"strategy"
],
"properties": {
"count": {
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"strategy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"has_next_page": {
"type": "boolean"
}
},
"additionalProperties": false
},
"max_results_requested": {
"type": "integer"
}
},
"additionalProperties": false
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "booking-hotel",
"task_name": "Booking.com Hotel API",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"url": "https://example.com/item-1",
"data": {
"price": "180",
"currency": "USD",
"price_basis": "180",
"price_value": 180,
"room_offers": [
{
"id": "id-1",
"beds": "sample",
"price": "180",
"taxes": "sample",
"nights": 1.5,
"payment": "sample",
"room_id": "id-1",
"capacity": 1.5,
"currency": "USD",
"breakfast": "sample",
"meal_plan": "sample",
"occupancy": "sample",
"room_name": "Stylish Shoreditch Loft with Balcony",
"conditions": "sample",
"refundable": true,
"tax_status": "sample",
"price_basis": "180",
"cancellation": "sample",
"quote_source": "sample",
"room_details": {
"source": "sample",
"room_id": "id-1",
"capacity": 1.5,
"facilities": [
{}
],
"descriptions": "sample",
"room_area_m2": 1.5,
"bed_configurations": [
{}
]
},
"source_total": 180,
"quote_room_id": "id-1",
"room_features": [
"sample"
],
"hotel_currency": "USD",
"policy_details": "2 guests",
"quote_complete": true,
"quote_currency": "USD",
"rate_is_genius": true,
"tax_exceptions": [
"sample"
],
"displayed_total": 180,
"quote_room_name": "Stylish Shoreditch Loft with Balcony",
"source_capacity": 1.5,
"source_subtotal": 180,
"excluded_charges": [
{}
],
"included_charges": [
{}
],
"optional_charges": [
{}
],
"breakfast_included": true,
"source_hotel_total": 180,
"conditional_charges": [
{}
],
"max_selectable_rooms": 1.5,
"source_payment_terms": {},
"source_hotel_subtotal": 180,
"total_including_taxes": 180,
"matches_requested_stay": true,
"observed_stay_verified": true,
"matches_requested_occupancy": true
}
],
"observed_stay": {
"checkin": "2026-06-14",
"checkout": "2026-06-21"
},
"offers_status": "sample",
"price_offer_id": "180",
"requested_stay": {
"rooms": 1.5,
"adults": 1,
"nights": 1.5,
"checkin": "2026-06-14",
"checkout": "2026-06-21",
"children": 1
},
"room_details_status": "2 guests",
"quote_display_currency": "USD"
},
"count": 1,
"query": "London",
"source": "sample",
"results": [
{
"price": "180",
"currency": "USD",
"price_basis": "180",
"price_value": 180,
"room_offers": [
{
"id": "id-1",
"beds": "sample",
"price": "180",
"taxes": "sample",
"nights": 1.5,
"payment": "sample",
"room_id": "id-1",
"capacity": 1.5,
"currency": "USD",
"breakfast": "sample",
"meal_plan": "sample",
"occupancy": "sample",
"room_name": "Stylish Shoreditch Loft with Balcony",
"conditions": "sample",
"refundable": true,
"tax_status": "sample",
"price_basis": "180",
"cancellation": "sample",
"quote_source": "sample",
"room_details": {
"source": "sample",
"room_id": "id-1",
"capacity": 1.5,
"facilities": [
{}
],
"descriptions": "sample",
"room_area_m2": 1.5,
"bed_configurations": [
{}
]
},
"source_total": 180,
"quote_room_id": "id-1",
"room_features": [
"sample"
],
"hotel_currency": "USD",
"policy_details": "2 guests",
"quote_complete": true,
"quote_currency": "USD",
"rate_is_genius": true,
"tax_exceptions": [
"sample"
],
"displayed_total": 180,
"quote_room_name": "Stylish Shoreditch Loft with Balcony",
"source_capacity": 1.5,
"source_subtotal": 180,
"excluded_charges": [
{}
],
"included_charges": [
{}
],
"optional_charges": [
{}
],
"breakfast_included": true,
"source_hotel_total": 180,
"conditional_charges": [
{}
],
"max_selectable_rooms": 1.5,
"source_payment_terms": {},
"source_hotel_subtotal": 180,
"total_including_taxes": 180,
"matches_requested_stay": true,
"observed_stay_verified": true,
"matches_requested_occupancy": true
}
],
"observed_stay": {
"checkin": "2026-06-14",
"checkout": "2026-06-21"
},
"offers_status": "sample",
"price_offer_id": "180",
"requested_stay": {
"rooms": 1.5,
"adults": 1,
"nights": 1.5,
"checkin": "2026-06-14",
"checkout": "2026-06-21",
"children": 1
},
"room_details_status": "2 guests",
"quote_display_currency": "USD"
}
],
"success": true,
"pagination": {
"count": 1,
"cursor": "cursor-page-1",
"strategy": "sample",
"next_cursor": "cursor-page-1",
"has_next_page": true
},
"max_results_requested": 1
},
"error": null
}Errors & retries
400Fix the fields listed inerrorsbefore retrying.428Connect the requested website account using the returned sign-in link.429Wait for the duration inRetry-After.5xxRetry transient failures with backoff. Keep the request ID.
A failed run has its own error inside the response. Retry it only when error.retryable is true.
More examples
Async request with polling
RUN=$(curl -s -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/booking/hotel" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.booking.com/hotel/gb/example.html"}')
RUN_ID=$(echo "$RUN" | jq -er '.run_id // empty') || { echo "$RUN" >&2; exit 1; }
POLL_DELAY=3
while true; do
RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/$RUN_ID")
STATUS=$(echo "$RESULT" | jq -r '.run_status')
if [[ "$STATUS" =~ ^(succeeded|failed|errored|cancelled|canceled|expired)$ ]]; then
echo "$RESULT"
break
fi
sleep "$(awk "BEGIN { print $POLL_DELAY * (0.9 + ($RANDOM % 21) / 100) }")"
POLL_DELAY=$((POLL_DELAY < 30 ? POLL_DELAY * 2 : 30))
[ "$POLL_DELAY" -gt 30 ] && POLL_DELAY=30
doneWait-for-results request
curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/booking/hotel" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.booking.com/hotel/gb/example.html","_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/booking-hotel/runs.