Search stays near a location
Input
checkin requiredCheck-in date, YYYY-MM-DD.
checkout requiredCheck-out date, YYYY-MM-DD.
location requiredFree-text place to search near: address, landmark, city or hotel name (e.g. "124 Rue Réaumur, Paris" or "Tour Eiffel"). It must name a place Booking.com can actually find. When several places share the name (e.g. "Paris"), the search is refused and the candidates are listed: add the country or region after a comma ("Paris, France"). Booking never answers "no match" — it quietly falls back to the nearest thing it can geocode anywhere in the world — so when the place it settles on shares nothing with what was asked, the search is refused instead of returning hotels somewhere else entirely. The place used is returned as resolvedLocation.
rooms optionalNumber of rooms.
Default: 1adults optionalNumber of adults.
Default: 2children optionalNumber of children.
Default: 0minRating optionalOnly keep results with a review score at or above this threshold (0-10 scale). Properties with no reviews yet are excluded. Set to 0 to disable filtering.
Default: 7Output
results requiredresolvedLocation optionaltotalPropertiesFound optionalFAQ
Search Booking.com hotels
Search Booking.com for accommodations by destination: name, hotel slug, address, guest rating, review count, and rating category. No login required.
Get Booking.com guest reviews
Read the guest reviews a Booking.com property lists. Returns the property name, its overall guest score and total review count, plus each review's guest first name and country, title, score out of 10, what they liked, what they did not, the room they stayed in, the number of nights, the month of the stay, the traveller type and the date the review was written. Takes the property path segment used by the other Booking.com scripts, e.g. "fr/hotelauroremontmartre". Use `count` to ask for more than the ten a single panel page holds; a property with fewer reviews than asked for simply returns what it has. Reviews come back in the panel's own "most relevant" order, which is not chronological and is not stable between sessions — the same property asked twice on different days can lead with different reviews, so treat one call as a sample rather than a fixed top of the list. Reviews are returned in the language each guest wrote them in, so a property's set can mix languages. Guests may leave a score with no written text, in which case the liked and disliked fields are empty. Properties with no reviews yet return an empty list, and a path segment that does not name a property is reported as unavailable rather than as an error.
Get Booking.com hotel details
Fetch a hotel's Booking.com listing: name, star rating, guest rating, review count, address, description, and image. No login required.