Get Google Flights fares
get_google_flights_faresSearch Google Flights by route and travel dates to retrieve fare options with prices, airlines, flight numbers, times, duration, stops, layovers, and emissions.
Instructions
Search Google Flights for a route and dates. Returns one row per flight option with price, airlines, flight numbers, departure and arrival times, duration, stops, layovers, and emissions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_google_flights_fares"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cabin | No | economy (default), business, or first. Premium economy is not supported. | |
| adults | No | Adult passengers, 1 to 9. Default 1. price_total is for all passengers; price_per_adult divides it. | |
| dedupe | No | true (default): an option already returned for the same route and dates in this run is skipped and not charged. | |
| routes | No | One route per line, origin to destination, for example JFK to LAX, JFK-LAX, or New York to London. Airport codes (3 capital letters) give exact airports; a city name lets Google pick the city's airports. From Clay, put the column inside a one item list. | |
| currency | No | ISO currency code for the prices, for example USD, EUR, GBP. Default USD. | |
| trip_days | No | Round trip only: days between departure and return, 1 to 60. Default 7. Ignored when return_date is set. | |
| trip_type | No | round_trip (default) or one_way. A round trip price is the round trip total, and the row lists the outbound flights. | |
| return_date | No | Optional. YYYY-MM-DD. Works with one departure date only; for several dates use trip_days. | |
| nonstop_only | No | true: keep only nonstop options; others are left out and not charged. Default false. | |
| max_charge_usd | No | Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. | |
| departure_dates | No | One or more outbound dates, YYYY-MM-DD, up to 330 days ahead. Each date is its own search. Empty: 21 days from today. | |
| max_flights_per_search | No | 1 to 100. Default 30. The actor reads the flight list Google renders on the search page, usually 6 to 35 options. |