get_recommended_destinations
Recommend destinations from a departure airport.
Use this whenever the traveler asks where to go. Only set filter arguments they explicitly asked for (month, airport, budget, weather, visa, tags). Omit all other filters so Sorted keeps its defaults. Never set a filter to false just because they did not mention it. When they name a continent or region, always set destination_tags (Africa → africa, Asia → asia, Europe → europe, Americas → americas, Middle East → middle-east, Caribbean → caribbean, Australia/Oceania → australia-oceania). Do not enable direct flights unless they asked. Passport names must match the visa table (USA, United Kingdom); aliases such as United States are accepted and normalized. source_location_code must be a supported origin, a city alias (PAR, LON, NYC), or ANYWHERE. ANYWHERE is fine for weather, region, or vibe asks that are not flight- or price-sensitive; it skips flight prices and direct-route filters. Use a supported airport (not ANYWHERE) for direct, cheap/budget, flight time, or layover asks. Do not use a destination airport_code from resolve_destination unless it is in the supported list. Never invent a destination list. Do not use this for live flight tickets. This tool returns data only. After a successful call, always call render_recommended_destinations so the destination carousel appears.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | Month when the traveler will travel. Omit unless specified. | |
| is_safe | No | Set true only if the traveler asked for safe destinations. Omit otherwise. | |
| sort_by | No | Result order. Omit unless the traveler asked to sort a specific way. | |
| currency | No | Upper-case currency code for prices. Omit unless the traveler specified a currency. | USD |
| max_price | No | Max price the traveler is willing to pay. Omit unless they specified a budget. | |
| page_size | No | Number of results to return. Omit unless the traveler asked for a specific count. | |
| passports | No | Passport countries for visa filtering. Use visa-table names such as USA and United Kingdom. | |
| user_tags | No | Interest handles from saved traveler preferences, not explicit requests. | |
| user_visas | No | Visas the traveler said they hold. Use exact uppercase values (UK, SCHENGEN, NEW_ZEALAND). | |
| is_visa_free | No | Set true only if the traveler asked for visa-free or eVisa destinations. Omit otherwise. | |
| is_one_layover | No | Set true only if the traveler asked to limit to at most one layover. Omit otherwise. | |
| is_weather_sun | No | Set only when the traveler asked about sunny weather. Omit otherwise. | |
| is_weather_rain | No | Set true only when the traveler asked for rainy weather. Omit otherwise. | |
| max_flight_time | No | Max flight time in hours. Omit unless the traveler specified a flight time limit. | |
| temperature_max | No | Max temperature in Celsius. Omit unless the traveler specified a temperature range. | |
| temperature_min | No | Min temperature in Celsius. Omit unless the traveler specified a temperature range. | |
| destination_tags | No | Destination interest handles the traveler asked for. Required for continents/regions: africa, asia, europe, americas, middle-east, caribbean, australia-oceania. Also features such as beach, hiking, romantic, kids-friendly. Combine feature and region tags when both are named (e.g. africa + beach). | |
| is_weather_mixed | No | Set only when the traveler asked about mixed or partly cloudy weather. Omit otherwise. | |
| is_direct_flights | No | Set true only if the traveler asked for direct flights. Omit otherwise. | |
| is_single_airline | No | Set true only if the traveler asked for a single airline or single ticket. Omit otherwise. | |
| selected_airlines | No | Airline codes to filter by. Omit unless the traveler named airlines. | |
| source_location_code | No | Departure IATA from Sorted's supported origins only: AMS, BCN, BER, BOS, CDG, DUB, FRA, JFK, LHR, SFO, SYD, YYZ. City codes and aliases PAR→CDG, LON→LHR, NYC→JFK (and sibling airports such as ORY, LGW, EWR) are accepted. ANYWHERE is fine when the ask is not flight- or price-sensitive (weather, region, vibe); it skips flight prices and direct-route filters. Use a supported airport (not ANYWHERE) for direct, cheap/budget, flight time, or layover asks. Do not use a destination airport_code from resolve_destination unless it is in the supported list (for example DXB is not a Sorted origin). | LHR |
| is_price_filter_enabled | No | Set true only when the traveler specified a budget (with max_price). Omit otherwise. | |
| is_weather_filter_enabled | No | Set true only when the traveler asked for weather or temperature constraints. Omit otherwise. | |
| is_flight_time_filter_enabled | No | Set true only when the traveler specified a max flight time. Omit otherwise. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||