v1
latestOpenAPI 3.1.02026-07-26180242448.0 KBGoogle Flights search
Search Google Flights.
Returns best_flights (Google's top 4 picks) and other_flights (the rest of the SSR-rendered result set), plus price_insights when Google flags a typical-price range. Each offer carries a booking_url deep link (built from the tfs token) that pre-selects that flight, and the response carries a search_url for the whole search.
For round-trips, follow an outbound offer's departure_token back into this endpoint to list the return-leg flights; each returned offer then carries a fully-selected selection_token / booking_url for the complete itinerary.
Note: Google Flights renders a "best picks" preview in SSR (~6-8 flights per direction for round-trips, 3-4 for one-way).
Query parameters
Departure IATA (e.g. JFK) or airport ID.
Departure IATA (e.g. JFK) or airport ID.
Arrival IATA (e.g. LHR) or airport ID.
Arrival IATA (e.g. LHR) or airport ID.
Outbound date — YYYY-MM-DD.
Outbound date — YYYY-MM-DD.
Return date (YYYY-MM-DD) — required for trip_type=round_trip.
Return date (YYYY-MM-DD) — required for trip_type=round_trip.
round_trip / one_way / multi_city.
round_trip / one_way / multi_city.
Adult passengers.
Adult passengers.
Children passengers.
Children passengers.
Cabin class.
Cabin class.
ISO-4217 currency code.
ISO-4217 currency code.
Country code.
Country code.
Language code.
Language code.
Max stops filter — applied client-side.
Max stops filter — applied client-side.
Max price filter — applied client-side.
Max price filter — applied client-side.
top (default) returns Google's ~6-8 'best' picks — fast. price returns the full price-sorted inventory (every carrier, the cheap long-layover fares) plus Google's own price floor / typical range / history. price is slower (a heavier render) and falls back to the 'top' set under load. Round-trip initial search only.
top (default) returns Google's ~6-8 'best' picks — fast. price returns the full price-sorted inventory (every carrier, the cheap long-layover fares) plus Google's own price floor / typical range / history. price is slower (a heavier render) and falls back to the 'top' set under load. Round-trip initial search only.
A 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.
A 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