cheapest_dates_tool
Find the cheapest fare per departure date within a date range for any origin-destination route. Supports one-way and round-trip with price and airline details.
Instructions
Cheapest fare for each departure date between start and end (YYYY-MM-DD) on origin→destination.
trip_length: None for one-way, or N for a round trip returning N days after departure. Returns {cheapest, days:[{depart, ret, price, airlines}], backend, warnings}. The 'graph' backend reads Google Flights' own price calendar (fast, ~60 days per call); 'sweep' searches each date individually. 'auto' picks graph when a browser is available.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"origin": "<origin>",
"destination": "<destination>",
"start": "<start>",
"end": "<end>"
},
"name": "cheapest_dates_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| seat | No | economy | |
| start | Yes | ||
| origin | Yes | ||
| backend | No | auto | |
| nonstop | No | ||
| currency | No | USD | |
| destination | Yes | ||
| trip_length | No |