Skip to main content
GET
Search Destinations
Turn free text into exact Booking destinations. Works on prefixes, so amsterd already resolves. Each result carries a dest_id and dest_type pair you can pass to /search to target an exact area instead of relying on free-text geocoding.

Query Parameters

string
required
Free-text destination, including prefixes — e.g. amsterd, Rome, Charles de Gaulle.
integer
default:"8"
Destinations to return. Maximum 20.
string
default:"en-us"
Locale for names and labels, e.g. fr, de.

Response

string
Echo of the requested text.
integer
Destinations returned.
Destination[]
Matching destinations, best match first.
The two-step workflow: resolve here once, cache the dest_id + dest_type, then pass both to /search on every subsequent query. That pins the search to exactly the city, district or airport you meant — free-text location re-geocodes each time and can drift to a same-named place in another country.

Example

Response
Each destinations request costs 3 credits. Failed requests are not charged.