Booking.com hub

Booking.com Property API

Everything a property page shows, from rooms and facilities to house rules, in one request.

GET /v1/booking/property

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.