Google Flights Scraper

The Google Flights Scraper returns every flight option Google Flights lists for a route and date: airlines, departure and arrival times, total duration, stops and layovers, each segment with its flight number, aircraft and legroom, the CO2 estimate, and the price. A search with a return date is a round trip, and each row is then an outbound flight priced for the whole trip. Two add-ons attach the matching return flights and the booking options of every airline and agency selling the trip.

Accepted input

• origin and destination: three-letter IATA airport codes such as JFK and LAX. Several airports may be combined with commas, JFK,EWR,LGA, and are searched together.
• departureDate, and returnDate for a round trip.
• adults, children, infantsInSeat and infantsOnLap: at most nine passengers in total and at most one lap infant per adult. Prices are the total for all passengers.
• cabin: economy, premium_economy, business or first.
• stops: any, nonstop, one_stop (one stop or fewer) or two_stops.
• currency: any three-letter code; prices default to USD.
• maxItems: the number of flights saved; 0 saves every option Google lists.

{
  "origin": "JFK",
  "destination": "LAX",
  "departureDate": "2026-12-10",
  "returnDate": "2026-12-17",
  "adults": 1,
  "cabin": "economy",
  "maxItems": 30
}

Response fields

position, is_best, trip_type, airlines, departure_airport, arrival_airport, departure_time, arrival_time, duration_minutes, stops, price, currency, segments, layovers, emissions_grams, emissions_typical_grams, emissions_difference_percent, search_departure_date, search_return_date, and Google's price assessment for the route as lowest_price, typical_price_low and typical_price_high.

{
  "position": 1,
  "is_best": true,
  "trip_type": "round_trip",
  "airlines": ["JetBlue"],
  "departure_airport": "JFK",
  "arrival_airport": "LAX",
  "departure_time": "2026-12-10T20:35",
  "arrival_time": "2026-12-10T23:54",
  "duration_minutes": 379,
  "stops": 0,
  "price": 372,
  "currency": "USD",
  "segments": [{ "flight_number": "B6 1723", "aircraft": "Airbus A320", "legroom": "32 in" }],
  "emissions_grams": 424000,
  "typical_price_low": 225,
  "typical_price_high": 550
}

Rows are in Google's order: the flights Google marks as best come first with is_best set, followed by the remaining options. Times are local to each airport.

Add-ons

enrichReturnFlights applies to round trips. It adds return_flights, the return options that pair with each outbound flight, each priced for the whole trip. It costs one request per outbound flight and is charged only when return flights are returned.

enrichBookingOptions adds booking_options: every airline and online agency selling the trip, with seller, fare_name, price and booking_url. On a one-way search the options are for the row's own flight. On a round trip a booking needs both directions, so the options are for the cheapest return flight, which is added as booking_return_flight. The add-on is charged only when booking options are returned.

Neither add-on runs on the free plan's trial rows.

Behaviour on partial results

A route that Google cannot price, such as a date in the past or an airport code it does not recognise, ends the run with a message rather than an empty success. An add-on that returns nothing leaves the row as it was, writes a line to the log, and is not charged.

Related Actors

The Google Flights Price Calendar returns the cheapest fare for every departure date in a window of up to 93 days, which identifies the date to search here.