Skip to content
Gridlode
Docs · Reference

Google Flights Search

GET /v1/travel/google/flights2 credits / requestcache 30 min

Flight options from Google Flights for a route and date, as a signed-out visitor sees them. Search by airport codes (several per side allowed), with a return date for round trips, adults and children, cabin class (economy, premium economy, business, first), a stop limit and currency. Results come in Google's two groups, best flights and other flights. Each itinerary has its price, airlines, departure and arrival airports and times, total duration, number of stops, layovers (with length and airport changes), and carbon emissions against the typical amount for the route. Each segment has its flight number, codeshare numbers, aircraft, legroom and duration. The response also includes Google's price insights (lowest price, whether prices are low, typical or high, the typical price range and about 60 days of price history), the overall price range, and the airports searched. Prices are totals for all passengers. For round trips you get the outbound options with their round-trip prices; return flights, booking options and fare details (bags, fare class) are not included. Blocked or failed requests and searches Google rejects are free.

Query parameters

from
string · required
Departure airport IATA code, e.g. JFK. Several airports: JFK,EWR,LGA.
to
string · required
Arrival airport IATA code, e.g. LAX. Several airports: LAX,BUR.
date
string · required
Outbound date, YYYY-MM-DD.
return_date
string
Return date, YYYY-MM-DD, for a round trip. The response lists the outbound options with their round-trip prices.
Default: null
adults
integer
Number of adult passengers.
Default: 1
children
integer
Number of children (2-11).
Default: 0
travel_class
string
Cabin class.
Default: "economy"
Allowed: economy, premium_economy, business, first
stops
string
Maximum stops: any, nonstop, 1 (at most one stop) or 2.
Default: "any"
Allowed: any, nonstop, 1, 2
currency
string
Price currency, e.g. USD, EUR, GBP.
Default: "USD"
hl
string
Interface language, e.g. en, fr, pt-BR (airport and airline names).
Default: "en"
gl
string
Country the search is made from (2-letter code); also picks the proxy exit country.
Default: "us"
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/travel/google/flights?from=JFK&to=LAX&date=2027-03-10" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Flights Search API page.