Booking.com

Booking.com Hotel Details API

Get one Booking.com property in full - rooms and rate plans with their offers, facilities, meals, house rules and fine print, check-in and check-out windows, review score with the per-category subscores, images, brand and location - priced for the stay you ask for, as JSON. Costs 1 credit per request.

POST/api/v1/booking/hotel

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

hotelstringrequired

Booking.com property URL or the bare page slug, 1-500 characters; query params are discarded. Chaining the url a /booking/search row returns is always cheapest - a bare slug under the wrong country_code is a real, BILLED 404.

Example: citizenm-austin-downtown

country_codestringdefault:us

Two-letter country code for the property page. Only consulted for a bare slug, and a wrong one is a real, BILLED 404.

checkinstring

Check-in date, YYYY-MM-DD. Must be sent together with checkout. Omit both and Booking prices a two-night range of its own choosing; the response echoes whichever dates were actually used.

Example: 2026-09-08

checkoutstring

Check-out date, YYYY-MM-DD. Must be later than checkin and sent together with it.

Example: 2026-09-10

adultsintegerdefault:2

Adult guests, 1 or more.

children_agesarray<integer>

AGES of the accompanying children, 0-17 each, up to 10 entries. Ages, not a count.

Example: [4, 9]

roomsintegerdefault:1

Rooms to price, 1 or more.

currencystringdefault:USD

ISO 4217 currency for every price in the response, 3 letters. Leave it out and Booking prices off the proxy exit, so two identical requests can disagree.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.booking.hotel("citizenm-austin-downtown", checkin="2026-09-08", checkout="2026-09-10")
print(results)

Response

"hotel_id": 9927207,

"name": "citizenM Austin Downtown",

"page_name": "citizenm-austin-downtown",

"url": "https://www.booking.com/hotel/us/citizenm-austin-downtown.html",

"description": "Conveniently located in the center of Austin, citizenM Austin Downtown provides air-conditioned rooms, an outdoor swimming pool, free WiFi and a shared lounge. This 4-star hotel offers a 24-hour front…",

"country_code": "us",

"city": "Austin",

"address": "617 Colorado Street, Austin, TX 78701, United States",

"postal_code": "TX 78701",

"region": "Texas",

"latitude": 30.268978,

"longitude": -97.743665,

"dest_id": "20126394",

"is_city_center": false,

"accommodation_type": "HOTEL",

"accommodation_type_id": 204,

"star_rating": 4,

"star_rating_type": "STARS",

"brand": "CitizenM",

"brand_logo": "https://r-xx.bstatic.com/xdata/images/xphoto/max240x120/574294720.jpg?k=67b336d097a280803556e099695bafa431c022cc7fd8b3305e534a6f9f97ce85&o=",

"review_score": 8.5,

"review_count": 2122,

"currency": "USD",

"hotel_currency": "USD",

"checkin": "2026-09-08",

"checkout": "2026-09-10",

"nights": 2,

"adults": 2,

"children_ages": [],

"rooms_requested": 1,

"price_from": 405.76,

"is_sold_out": false,

"image": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/780625989.jpg?k=31a6c98650946ec2456c0fa013a214291bb2be1dd86bfdbf73ab46c524c9abd8&o=",

"checkin_from": "2:00 PM",

"checkin_until": null,

"checkout_from": null,

"checkout_until": "11:00 AM",

"min_checkin_age": 18,

"pets_allowed": "NO",

"children_allowed": true,

"min_children_age": 0,

"cribs_allowed": false,

"extra_beds_allowed": false,

"accepts_cash": "PATP_PROPERTY_DOES_NOT_ACCEPT_CASH",

"license_numbers": [],

"is_sustainable": true,

"has_designated_smoking_area": false,

"response_time": 4498,

"credits_used": 1,

"credits_remaining": 4820

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") results = client.booking.hotel("citizenm-austin-downtown", checkin="2026-09-08", checkout="2026-09-10") print(results)