Google Flights Search
Search Google Flights for one-way, round-trip, or multi-city itineraries with prices, emissions, and price insights.
Prices
price is the price exactly as Google Flights displays it: the total for the
entire party (all passengers combined), including mandatory taxes and
fees. Optional extras such as checked bags or seat selection are not
included. price_type is always total.
Round trips: the two-step flow
Google Flights selects a round trip in two steps — first the outbound, then the return — and this API mirrors that:- Search with
trip_type=round_trip,outbound_date, andreturn_date. Each offer’slegscontain the outbound segments only, and itspriceis the lowest complete round-trip total available with that outbound (Google pairs it with the cheapest compatible return). - Pick the return: call this endpoint again with the same parameters plus
the chosen offer’s
departure_token. The response lists the return-leg options; each offer’spriceis the exact final round-trip total for that outbound + return pairing, and itsbooking_urlopens the Google Flights booking page for the fully selected itinerary. Use itsselection_tokenwith Booking Options to list per-provider prices.
booking_url
opens the booking page directly and departure_token is null.Authorizations
Query Parameters
Departure IATA (e.g. JFK) or airport ID.
Arrival IATA (e.g. LHR) or airport ID.
Outbound date — YYYY-MM-DD.
Return date (YYYY-MM-DD) — required for trip_type=round_trip.
round_trip / one_way / multi_city.
one_way, round_trip, multi_city Adult passengers.
1 <= x <= 9Children passengers.
0 <= x <= 80 <= x <= 40 <= x <= 4Cabin class.
economy, premium_economy, business, first ISO-4217 currency code.
Country code.
Language code.
Max stops filter — applied client-side.
any, nonstop, one_stop, two_stops Max price filter — applied client-side.
x >= 1A departure_token from a round-trip offer. When set, the search returns the return-leg flights for that selected outbound (pass the same departure_id/arrival_id/dates as the original search). Round-trip only.
Response
Successful Response
Response for GET /api/v1/flights/search.
Typical price range insight for the searched route.
one_way, round_trip, multi_city Canonical Google Flights tfs URL for this search (in the requested language; market and prices follow gl/currency) — open to view and book the listed flights.

