search_destinations
Find destinations and airports
scope: searchread-only
Try it →Turns a place name into ids: place_id for search_hotels (city, region, country or hotel) and airport IATA codes for search_flights. Always the first step for hotels and flights.
Description for the model (tools/list)
Use this when a place name needs to be turned into ids for a search: cities, regions, countries and hotels for search_hotels (place_id) and airports for search_flights (IATA code). Returns up to 10 matches per type.
Parameters
| Parameter | Type | Default | Description (from the schema) |
|---|---|---|---|
query required | string | Place, hotel or airport name, at least 3 characters | |
types | string | "hotel,flight" | Comma-separated id types to return: hotel, flight. Default both |
language | string | "en" | en or nl |
Key response fields
hotel_places[].place_id | Id for search_hotels: city:…, destination:…, region:…, country:… or hotel:… |
hotel_places[].kind | Kind of place (city, destination, hotel, …) |
airports[].iata | IATA code for search_flights |
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_destinations",
"arguments": {
"query": "Barcelona"
}
}
}structuredContent (real sandbox response, shortened, without prices)
{
"query": "Barcelona",
"hotel_places": [
{
"kind": "city",
"name": "Barcelona",
"country": "Spain",
"region": "Barcelona & surrounding area",
"place_id": "city:587"
},
{
"kind": "city",
"name": "Barcelona",
"country": "Venezuela",
"region": "Venezuela",
"place_id": "city:27658"
},
{
"kind": "destination",
"name": "Barcelona & surrounding area",
"country": "Spain",
"place_id": "destination:1315"
},
"… 7 more"
],
"airports": [
{
"iata": "BCN",
"name": "Barcelona–El Prat Josep Tarradellas Airport",
"city": "Barcelona",
"country": "Spain"
},
{
"iata": "BLA",
"name": "General José Antonio Anzoátegui International Airport",
"city": "Barcelona",
"country": "Venezuela"
}
],
"prices_hidden": true
}