Booking.com Property API
Everything a property page shows, from rooms and facilities to house rules, in one request.
GET /v1/booking/property1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/booking/property reads one property by its page URL. url is the url from a search result, such as https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html; a language suffix and query string are ignored. language (default en-us) sets the language of the text and currency (default USD) the prices the page shows for meals and extra beds.
The property carries id (pass it to the reviews route as propertyId), name, url, pageName, accommodationType, stars, description, finePrint, the address and coordinates, reviewScore, reviewCount and category scores, the brand, languagesSpoken, popularFacilities and highlights by category. meals lists what is served and whether it is included; rooms gives each room's beds, size, occupancy, facilities and photos, without prices, which depend on dates. photos holds up to 200 of the gallery and photoCount its total. policies covers check-in and check-out, pets, children and beds, accepted cards, quiet hours and other house rules; questions lists guest questions with the property's answers.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Booking.com Property API FAQ
Where do I find a property's URL?
Every property in GET /v1/booking/search has a url. Pass it as url, or copy the address of a property page on the site. Shangri-La The Shard, London is https://www.booking.com/hotel/gb/shangri-la-at-the-shard-london.html.
Why are there no room prices?
Room prices depend on the dates and guests. Use GET /v1/booking/search with checkIn, checkOut and adults for prices; this route returns what stays the same: the rooms, beds, facilities and policies.
How do I get the property's reviews?
Pass property.id as propertyId to GET /v1/booking/properties/{propertyId}/reviews. property.scores already holds the guests' average for each category.
What if the URL is not a property?
lookupStatus is not_found and property is null. A URL that is not a Booking.com property page at all is refused with HTTP 400.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.