Google Flights Scraper

Search Google Flights for any route and date and get every fare Google lists: price, airlines, flight numbers, times, stops, layovers, aircraft and CO2, plus Google's own low / typical / high price verdict and about 60 days of price history for the trip. Round trips can list the return flights you can pair with each outbound. Clean rows for a spreadsheet, a price tracker or an alert.

What you can do with it

• Track fares on a schedule: run the same route daily and watch the price move. Dates can be written +30 (30 days from today) so a saved run never goes stale. Each run also saves Google's 60-day price history for the trip, so a new route has a chart on day one.
• Know if a fare is a good one: every row carries Google's verdict (low, typical or high) and the typical price range for the trip.
• Pick the whole round trip: set returnFlightsForTop and each of the best outbound flights comes with its return options, priced as the full trip.
• Compare routes and dates in one run: list several routes or dates under "More routes and dates".
• Filter before you pay: nonstop only, a price ceiling, departure and arrival time windows, layover length, connecting airports, bags included, chosen or excluded airlines, no basic economy, lower emissions. Filters and the result cap apply before you are charged.
• Round trip or one way, any cabin, any currency, adults, children and infants.

Input

Field	What it does
origin, destination	Three-letter airport codes (SFO, LAX).
departureDate, returnDate	YYYY-MM-DD, or +N days from today. No return date = one way.
searches	More routes or dates; each item can set origin, destination, departureDate, returnDate (an empty returnDate means one way).
adults, children, infantsInSeat, infantsOnLap	Passengers (up to 9).
cabinClass, currency, language	Cabin, currency code, locale.
maxStops, maxPrice, airlines, excludeAirlines, excludeBasicEconomy, hideSelfTransfer, lessEmissionsOnly	Filters. airlines takes codes (UA, DL) or alliances (STAR_ALLIANCE, SKYTEAM, ONEWORLD).
earliestDepartureHour, latestDepartureHour, earliestArrivalHour, latestArrivalHour	Time windows, 0-23, local time.
maxDurationMinutes, minLayoverMinutes, maxLayoverMinutes, connectingAirports	Trip length and connection rules.
carryOnBags, checkedBags	Prices include this many bags per traveler.
returnFlightsForTop, maxReturnOptions	Round trips: list return flights for the top N outbound flights, cheapest first.
sortBy	best (Google's order), price, duration, departure, arrival.
includePriceHistory	Save the verdict and 60-day history as the PRICE_HISTORY record (on by default).
maxResults	Hard cap on flights returned and charged.

Example:

{ "origin": "SFO", "destination": "LAX", "departureDate": "+30", "returnDate": "+34", "maxStops": 0, "returnFlightsForTop": 5, "maxResults": 20 }

Output

One item per flight option:

{
  "rank": 1, "isCheapest": true, "isFastest": false, "category": "best",
  "price": 148, "currency": "USD", "priceLevel": "typical", "typicalPriceLow": 70, "typicalPriceHigh": 175,
  "airlines": ["Frontier"], "flightNumbers": ["F9 2858"],
  "origin": "SFO", "destination": "LAX",
  "departure": "2026-11-10T21:27", "arrival": "2026-11-10T22:54",
  "duration": "1h 27m", "durationMinutes": 87, "stops": 0, "layovers": [],
  "segments": [{ "flightNumber": "F9 2858", "aircraft": "Airbus A321neo", "from": "SFO", "to": "LAX", "legroom": "28 inches" }],
  "returnOptions": [{ "price": 148, "flightNumbers": ["F9 4593"], "departure": "2026-11-14T19:03", "arrival": "2026-11-14T20:25", "stops": 0 }],
  "carbonGrams": 53000, "carbonVsTypicalPercent": -43,
  "tripType": "round-trip", "searchReturnDate": "2026-11-14",
  "googleFlightsUrl": "https://www.google.com/travel/flights/search?..."
}

category is Google's own grouping ("best" or "other"). On a round trip, price is the price of the whole trip and each row describes the outbound flight; with returnFlightsForTop, returnOptions lists return flights, each price being the whole trip with that outbound. googleFlightsUrl opens the same search on Google Flights.

The PRICE_HISTORY record (key-value store) holds one entry per search: priceLevel, typicalPrice, typicalPriceLow/High, cheapestPrice and history (about 60 daily points of the cheapest price for that trip). Google does not always publish a verdict, for example when filters narrow the search; then the fields are empty.

Compared with other Google Flights actors

Measured 2026-10-28, same searches, same hour:

	This actor	lergassy/google-flights-scraper	johnvc/Google-Flights-Data-Scraper
SFO-LAX, round trip	65 flights	65 flights, all the same fares and times	60 flights (earlier run)
JFK-LHR, round trip, one page	84 flights	not run	20 flights
Price per 1,000 flights	$0.60-0.85 by plan	$0.70-1.00	about $0.50-1.50 ($0.03 per page of up to 60)
Price verdict and typical range, layovers, return flights, direct Google link	yes	yes	no
60-day price history saved per search	yes	no	no

Where they still win: lergassy has a flexible-date price calendar, "anywhere" destination search, multi-city trips and booking options with seller links, and johnvc has booking options. This actor does not have those yet.

Pricing

Pay per result: you are charged for each flight option returned (flight-scraped). A run that finds nothing fails instead of silently returning an empty dataset.

Limits and notes

• Prices and availability change by the minute; check the fare with the airline or a travel site before you book.
• Returns what Google shows for the search: no booking links, no calendar view, no multi-city trips.
• Public data only. Not affiliated with Google.

Feedback and requests

Missing a field or an option? Open an issue in the Issues tab and tell us what you need.