search_flights
Find the best airfare deals on Google Flights by specifying departure and destination airports, dates, travelers, seat class, and stop preferences.
Instructions
Search Google Flights for the best prices.
Tries multiple departure airports (default: Nice NCE, Marseille MRS).
All airports must be IATA codes. If you only know a city name, call find_airport
(or find_airports_near) first to resolve it.
Args:
to_airport: IATA destination code(s), comma-separated for multi-airport cities (e.g. "BCN" or "LHR,LGW,STN")
departure_date: Departure date YYYY-MM-DD
return_date: Return date YYYY-MM-DD (empty for one-way)
from_airports: Comma-separated IATA departure codes (default: NCE,MRS)
adults: Number of adults (default 2)
children: Number of children (default 2)
infants_in_seat: Infants with seat (default 0)
infants_on_lap: Infants on lap (default 0)
seat: Seat class: economy, premium-economy, business, first
max_stops: Max stops: -1 = no limit (default), 0 = direct only, 1 = max one stop
airlines: Comma-separated IATA airline codes to restrict to (e.g. "AF,U2"); empty = all
currency: ISO currency code (default EUR)
language: Language code (default fr)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seat | No | economy | |
| adults | No | ||
| airlines | No | ||
| children | No | ||
| currency | No | EUR | |
| language | No | fr | |
| max_stops | No | ||
| to_airport | Yes | ||
| return_date | No | ||
| from_airports | No | ||
| departure_date | Yes | ||
| infants_on_lap | No | ||
| infants_in_seat | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |