Skip to main content
Piloterr
Back to library

Booking Location Search API

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.

Active3 credits = 1 requestGET/v2/booking/location/search

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.

Returns the same suggestion list as the Booking search box: dest_id, dest_type, label, coordinates and country. There is no pagination object.

QuickstartLink to Quickstart

https://api.piloterr.com/v2/booking/location/search?query=Paris&language=fr
https://api.piloterr.com/v2/booking/location/search?query=Lyon&language=fr

ParametersLink to Parameters

Parameter Type Required Description
query string yes Free text. Example: Paris, Lyon, CDG.
language string no Booking locale: fr, en-gb, en-us, de, es, it, pt-pt, nl, … Aliases: en, uk, gb, pt, zh, br.

Response fieldsLink to Response fields

Field Type Description
results[].dest_id string Booking destination id
results[].dest_type string city, district, airport, landmark, region or country
results[].label string Full suggestion label
results[].title string Short title
results[].subtitle string Region or country line
results[].country_code string ISO country
results[].latitude number Latitude
results[].longitude number Longitude

Use casesLink to Use cases

  • Resolve a city name before a hotel search.
  • Offer an airport or landmark autocomplete.
  • Disambiguate Paris the city from Disneyland Paris.

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.

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