SCscrapebadger
Google Flights

Google 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).

get/v1/google/flights/search

Request

Query parameters

departure_idstring required

Departure IATA (e.g. JFK) or airport ID.

arrival_idstring required

Arrival IATA (e.g. LHR) or airport ID.

outbound_datestring required

Outbound date — YYYY-MM-DD.

return_datestring nullable

Return date (YYYY-MM-DD) — required for trip_type=round_trip.

trip_type'one_way' | 'round_trip' | 'multi_city'

round_trip / one_way / multi_city.

adultsinteger

Adult passengers.

childreninteger

Children passengers.

infants_in_seatinteger
infants_on_lapinteger
travel_class'economy' | 'premium_economy' | 'business' | 'first'

Cabin class.

currencystring

ISO-4217 currency code.

glstring

Country code.

hlstring

Language code.

stops'any' | 'nonstop' | 'one_stop' | 'two_stops'

Max stops filter — applied client-side.

max_priceinteger nullable

Max price filter — applied client-side.

sort_by'top' | 'price'

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.

departure_tokenstring nullable

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

departure_idstring required
arrival_idstring required
outbound_datestring required
return_datestring nullable
currencystring
trip_type'one_way' | 'round_trip' | 'multi_city'
search_urlstring nullable

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.

Changes

No recorded changes to this operation across all 1 revision of this API.