Search Dates
search_datesRead-onlyIdempotent
Find the cheapest travel dates between two airports within a date range. Supports one-way and round-trip searches for flexible trip planning.
Instructions
Find the cheapest travel dates between two airports within a date range.
Returns a list of dates with their prices, useful for flexible travel planning. Supports both one-way and round-trip searches.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | Departure airport IATA code(s), comma-separated for multiple (e.g., 'JFK' or 'JFK,LGA') | |
| destination | Yes | Arrival airport IATA code(s), comma-separated for multiple (e.g., 'LHR' or 'LHR,CDG') | |
| start_date | Yes | Start of date range in YYYY-MM-DD format | |
| end_date | Yes | End of date range in YYYY-MM-DD format | |
| trip_duration | No | Trip duration in days for round-trips | |
| is_round_trip | No | Search for round-trip flights | |
| airlines | No | Filter by airline IATA codes (e.g., ['BA', 'AA']) | |
| cabin_class | No | Cabin class: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST | ECONOMY |
| max_stops | No | Maximum stops: ANY, NON_STOP, ONE_STOP, TWO_PLUS_STOPS | ANY |
| departure_window | No | Departure time window in 'HH-HH' 24h format (e.g., '6-20') | |
| sort_by_price | No | Sort results by price (lowest first) | |
| passengers | No | Number of adult passengers |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||