Do I need airport codes before searching flights?

Not necessarily. Use `find_airport` if you only have a city or airport name, then pass the IATA codes into `search_flights`.

What does a flight search return?

`search_flights` returns live offers with airlines, departure and arrival times, duration, stops, baggage, emissions, and booking deadlines.

Can I look for direct flights or specific cabin classes?

Yes. Set `max_connections` to `0` for direct-only results, and choose the cabin class you want, from economy through first class.

How do I get refreshed pricing before booking?

Use `get_offer` on a specific offer ID to refresh the price and confirm availability. The search response also includes the IDs needed for booking handoff.

Flight Search — Live flights with prices &

Flight Search finds live flight availability and pricing across airlines for any route — one-way, round-trip, or flexible dates. Get real-time fares, baggage allowances, emissions data, number of stops, and booking deadlines in a single search.

It searches actual live inventory, not cached prices, so results reflect what's bookable right now. You can scan a date window to find the cheapest travel days, filter to direct-only flights, and narrow by airline. Results include IDs for handoff to a booking tool.

Use price_calendar, popular_routes, and where_to_fly to discover cheap fares and destinations — each result includes a booking link so users can complete purchase directly.

What you can do

search_flights — search for flights between two airports on a specific date with price, stops, and duration
search_dates — scan a date range to find the cheapest days to fly a given route
find_airport — look up IATA airport codes from city or airport names
get_offer — refresh a specific offer to get current pricing before purchase
price_calendar — see the cheapest fare for each day of a month on a route, with a direct booking link per day
popular_routes — discover the cheapest destinations to fly to from any city, sorted by price with booking links
where_to_fly — find the cheapest destinations from an origin across all dates ("where can I fly cheaply from London?")
airline_routes — see the busiest routes for a specific airline by annual passenger volume

Who it's for

Travelers planning trips, travel agents building itineraries, and anyone looking for cheap flight deals.

How to use it

If you don't know the IATA codes, call find_airport first.
Call search_flights with origin, destination, and departure date for live bookable results.
If dates are flexible, use search_dates to find the cheapest day in a window, then search_flights on that date.
To browse cheapest fares day-by-day, use price_calendar — each day includes a booking link.
Not sure where to go? Use where_to_fly or popular_routes to find the cheapest destinations from your city.
Before booking via the platform, call get_offer to confirm current pricing.