cheapest_destinations
ChatGPTFind cached indicative fares and filter destinations locally by geography, climate, coast, island, elevation or terrain relief, beach or hiking traits, culture, parks, population, connectivity, and route trip-duration suitability. Use population_level=low for quieter small-city options, but note that it is a global population band, not a measure of crowds or tourism: a small city may still be busy with visitors. Other low/medium/high values are also global bands, not ranks within a country; museum_level=low means no notable museum signal, not no museums. National-park distance is to the park centre. Monthly air and water filters require month. Prices are per adult. Always link the returned search_url from a short label; never paste the raw URL.
compare_airports
ChatGPTCompare cached indicative fare samples in an interactive airport comparison across airports of the origin city, destination city, or both. Prices are per adult. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text. Outbound and inbound are calculated separately. Missing prices mean no cached observation, not that no flight exists.
destination_profile
ChatGPTUse this tool when the user asks what a place is like, when to visit, how warm its air or water is, how far the coast is, what national parks or museums are nearby, or when comparing destinations before choosing one. Climate values are 1991–2020 normals, not a forecast. Beach objects are not available; the tool provides only distance to the coastline and the derived beach_destination trait, meaning the coast is within 10 km and at least one month has water warmer than 20 °C. The nearest national park distance is measured to the park centre, not an entrance or boundary. museum_level=low means no notable museum signal, not that there are no museums. Missing fields mean the source has no measurement; do not invent values.
flight_prices
ChatGPTFind cached indicative 'from' fares for a route and render interactive flight cards. Prices are per adult. These are historical observations, not live availability or booking offers. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text.
flight_prices_filtered
ChatGPTFind cached indicative fares with baggage, cabin, direct-flight, budget, flexible-date, and trip-duration filters and render interactive flight cards. Prices are per adult. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text. Airline, departure-time, and transfer-count filters are applied only to the returned cache sample and are reported in query_coverage. Use flight_prices for requests that do not need these filters.
open_search
ChatGPTBuild an Aviasurf live-search URL with dates, passenger composition, cabin class, currency, and locale. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text. This opens live search; it does not confirm a fare or availability.
price_calendar
ChatGPTShow cached indicative price observations in an interactive calendar by day, by month, or as observed departure/return date pairs. Prices are per adult. Every monthly row includes sample_size and sample_sufficient. A month with sample_sufficient=false is a limited cached observation, not a reliable monthly minimum or evidence of seasonality; state that limitation instead of drawing a seasonal conclusion. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text. Missing dates mean no cached observation, not that no flight exists.
resolve_place
ChatGPTResolve a city, airport, or country name to IATA/location candidates. Returns every plausible candidate instead of guessing, and includes airports for city candidates.
route_facts
ChatGPTSummarize a cached fare sample in an interactive route profile: price statistics, airlines observed, travel duration, route distance, and city airports. Prices are per adult. Always link the returned search_url from a short label in the answer language, for example "Check live prices on Aviasurf"; never paste the raw URL as text. direct_seen means only that a nonstop option appeared in the sample; never infer that direct flights do not exist.
