Skip to main content
Piloterr
Back to library

Booking Hotel Info API

Property page: description, facilities, coordinates and photos for a Booking hotel URL.

Active3 credits = 1 requestGET/v2/booking/hotel/info

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Queries Booking.com through an unlocked browser session and returns structured JSON. language is the Booking locale suffix (fr, en-gb, de, …), not a country domain. currency is an ISO 4217 code sent as selected_currency. One call returns one page.

Dates and guests are forwarded to the property URL. Room rows are included when Booking renders the rate table in the unlocked HTML. Photos exclude flag sprites.

QuickstartLink to Quickstart

https://api.piloterr.com/v2/booking/hotel/info?query=https://www.booking.com/hotel/fr/elysee-montmartre.fr.html&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr&currency=EUR
https://api.piloterr.com/v2/booking/hotel/info?query=https://www.booking.com/hotel/fr/sax-paris-lxr-hotels-resorts.fr.html&check_in=2026-06-15&check_out=2026-06-18&adults=2&language=fr&currency=EUR

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full https://www.booking.com/hotel/{country}/{slug} URL.
check_in string no Check-in date, YYYY-MM-DD. Optional. Must be before check_out.
check_out string no Check-out date, YYYY-MM-DD. Required when check_in is set.
adults integer no Adults. Default 2.
children integer no Children. Default 0. Without children_ages, each child is treated as age 8.
children_ages string no Comma-separated ages, one per child, 0-17.
rooms integer no Rooms. Default 1.
language string no Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br.
currency string no ISO 4217 code. Default USD. Example EUR.

Response fieldsLink to Response fields

Field Type Description
name string Property name
url string Hotel URL without tracking query
description string null
facilities string[] Listed amenities
images string[] Photo URLs
latitude string null
longitude string null
rooms object[] Name and price when the rate table is present
currency string Requested currency

Use casesLink to Use cases

  • Show a property sheet after a search result click.
  • Collect amenities and the written description.
  • Attach coordinates to a map pin.

Error codesLink to Error codes

Code Description
400 Missing query, unknown language, bad currency, or checkout not after check-in.
404 The page was fetched but no matching records could be parsed.
500 The unlocked fetch failed or the page was blocked.

Related APIs

Expand your data capabilities with these complementary tools.

Booking Attraction Info/v2/booking/attraction/info

One Booking.com attraction page.

GET3 credits = 1 requestActive
Booking Attraction Search/v2/booking/attraction/search

Things to do on Booking.com for a city or an attractions search URL.

GET3 credits = 1 requestActive
Booking Car Search/v2/booking/car/search

Car rental city rates and suppliers from Booking.com cars pages.

GET3 credits = 1 requestActive
Booking Countries/v2/booking/destination/countries

Booking.com country index with hotel counts.

GET3 credits = 1 requestActive
Booking Destination/v2/booking/destination/info

Booking hub for a country, region, city, district, landmark or airport URL.

GET3 credits = 1 requestActive
Booking Flight Search/v2/booking/flight/search

Flight offers for an IATA pair such as PAR-LON, or a Booking flights URL. On an IATA pair, dates are optional. A flights URL is fetched as-is and dates are not applied.

GET3 credits = 1 requestActive
Booking Hotel Reviews/v2/booking/hotel/reviews

Guest comments for a Booking hotel URL. Featured reviews on the property page are used when the review list is not rendered.

GET3 credits = 1 requestActive
Booking Hotel Search/v2/booking/hotel/search

Search Booking.com stays by city name, or by a city, region, district, landmark, airport or search URL. A hotel page URL belongs on hotel info.

GET3 credits = 1 requestActive
Booking Location Search/v2/booking/location/search

Autocomplete a place name, or a Booking city URL such as https://www.booking.com/city/fr/paris.fr.html. The URL is read as the place name. return_page_source is not supported and returns 400.

GET3 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included