Google Flights

Collect fares and itineraries from Google Flights. Compare destinations and travel dates in one run, or look up airports by name or IATA code.

Features

Process	What you get
Get Flights by Airport IATA	Available one-way and return itineraries for airport codes
Get Flights by Airport name	Itineraries for matching airports or cities
Search Airports	Airport names, cities, codes and identifiers
Flight filters	Cabin, passengers, stops, airlines, alliances and maximum fare

Fares and availability depend on the search date and source response. Name searches select the first matching airport; IATA codes give a more precise route.

Quick start

{
  "operation": "gfi",
  "departureIATA": "LAX",
  "arrivalIATA": ["LAS", "MUC"],
  "maximum": 3,
  "currency": "USD"
}

Omit departureDate to search 30 days from today. Set an explicit YYYY-MM-DD date for a specific trip. Add arrivalDate for a round trip. Use departureDateRng and arrivalDateRng to compare dates through the specified end dates. Dates must be within the next 330 days; return dates before departure are skipped.

Choose gfi for IATA codes, gfn for airport or city names, or sa for airport details. When a city has several airports, name search selects its first matching airport; use a specific IATA code for precise routing.

maximum limits flights per destination/date combination. maxResults limits real results across the run, and maxSearches limits destination/date combinations. Google's best flights are returned first; enable includeOtherFlights to include more options. Google may expose fewer flights than your chosen limit.

Output

Each flight row includes the departure and arrival airports, dates, currency, fare, airlines, passenger counts, flight legs, outbound duration and a Google Flights search link. Legs include airport codes, local departure/arrival timestamps with time-zone offsets, carrier codes, flight numbers and aircraft codes when supplied.

For round trips, the actor selects the first available return option for each outbound option and reports that pair's quoted fare. details.duration describes the outbound journey. Fares are Google's quote for the requested passenger group and can change before booking; the search link is not a booking confirmation.

Airport mode returns departure and arrival objects for each requested pair.

Search tips

Use IATA codes for the quickest searches. Broad date ranges and round trips require more searches. Airline codes override the alliance filter. Stops are 0 for any, 1 for nonstop, 2 for one stop or fewer, and 3 for two stops or fewer.

Direct connections are used by default. If Google blocks a run, select another proxy and try again. For support, share the run URL and the affected search.

Unsuccessful lookups

Where listed in the Pricing tab, a handled lookup problem that prevents a run from returning any real results produces one clear error record and a single $0.02 unsuccessful-lookup fee, in addition to any listed start fee.

Pricing

Each valid pay-per-event run with at least one input includes a minimum charge of 100 result units, shared across all inputs in that run. Any placeholder rows are clearly marked and contain no scraped data; filter them out when exporting. Each separate run has its own minimum, including scheduled or API runs. Platform usage is included.