Booking.com Property Search API
Properties for any destination and stay, priced in your currency, up to 100 a page.
GET /v1/booking/search1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/booking/search searches a destination for a stay. query is a city, region, district, landmark, airport or property name. checkIn defaults to 14 days from today (UTC) and checkOut to one night later; adults defaults to 2, rooms to 1, and childrenAges lists each child's age (5,9). currency (default USD), language (default en-us) and country (default us) set how prices and labels read: the site decides from the visitor country whether prices include taxes. filters takes the site's own filter ids (one the site does not apply is a free 400) and sort one of nine orders, lowest price first by default; limit is 1 to 100 (25 by default).
The answer names the destination the site matched, echoes the stay the prices are for and counts the properties (totalCount). Each property carries id (pass it to the reviews route), name, url, accommodationType, stars, reviewScore, reviewCount, locationScore, address, latitude, longitude, district, distanceFromCentre, photo, freeCancellation, noPrepayment, mealPlan, its rooms and a price: amount for the whole stay, currency, taxesIncluded, taxesAndCharges when added on top, originalAmount before a discount and perNight (the nightly room rate, without the per-night fees amount includes; US visitors only). The first page lists availableFilters. Pass page.nextCursor back as cursor while page.hasMore is true.
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 Search API FAQ
What stay are the prices for by default?
Check-in 14 days from today (UTC), one night, 2 adults, 1 room, in US dollars, as a visitor from the United States sees them. data.stay states the stay every price in the answer is for.
Are taxes included in the price?
As on the site, that depends on the visitor country. With country=us prices are before taxes and charges, and price.taxesAndCharges says how much is added. With country=gb, de and most of Europe the price includes them. price.taxesIncluded tells you which.
Why does a later page hold fewer than limit properties?
The default order, lowest price first, is the one the site pages consistently. The site reshuffles its popularity order between requests, so a property can move across a page boundary: one already returned is left out, never repeated, and counted in page.droppedCount, and a few can be missed. Use popularity for the site's own top picks, not for a complete walk.
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.