# Google Flights Scraper: Fares, Flight Numbers and Layovers (`themineworks/google-flights-scraper`) Actor

Scrape Google Flights by route and date: one row per itinerary with price, airlines, flight numbers, departure and arrival times, stops, layovers, aircraft, CO2 and a booking link. One way or round trip, many routes per run. No login.

- **URL**: https://apify.com/themineworks/google-flights-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Travel, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.63 / 1,000 itineraries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Flights Scraper: Fares, Flight Numbers and Layovers

[![30 Google Flights itineraries for JFK to LAX in 11 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/google-flights-scraper-hero.png)](https://console.apify.com/actors/sO8KiYqy48Rf4AVhC/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Google Flights itineraries for any route and date, one row per itinerary with price, airlines, flight numbers, departure and arrival times, stops, layovers, aircraft, legroom, CO2 and a booking link. No login, no cookies, no API key. You pay $0.90 per 1,000 itineraries on the Free plan and $0.63 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

Updated 12 Nov 2026: first release. One way and round trips, airport and city codes, batch routes and dates, passengers and cabin, stops and airline filters, Google's price level and typical price range, booking link per itinerary. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The full list, not the first screen.** Each search returns Google's whole result set for the route, usually 100 to 300 itineraries on a busy route (259 for Mumbai to Delhi in our test), best ranked first. `maxResults` caps it.
- **Every leg in its own field.** Flight numbers, operating carrier ("SkyWest Airlines as American Eagle"), codeshare numbers, aircraft, legroom, local times and CO2 per leg, and each layover with its airport, city and minutes, so a spreadsheet can filter on any of them.
- **Many routes and dates in one run.** Put a route map or a week of dates in `routes`; one run pays one start fee. In our test, 10 searches returned 1,000 rows in one run.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/sO8KiYqy48Rf4AVhC/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Food and local services family:** [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 30 itineraries from New York JFK to Los Angeles 30 days from today. It took 11 seconds in our test run:

```json
{
  "origin": "JFK",
  "destination": "LAX",
  "departureDate": "+30 days",
  "maxResults": 30
}
```

Add a `returnDate` for a round trip, or list more searches in `routes`. Relative dates such as `"+30 days"` keep a scheduled run looking the same distance ahead.

Apify's free plan includes $5 of credit every month, which covers about 5,500 itineraries at this actor's price.

#### Copy to your AI assistant

```text
themineworks/google-flights-scraper on Apify. Searches Google Flights by route and date and returns one flat row per itinerary with price, airlines, flight numbers, times, stops, layovers, legs, CO2 and a booking link, with no login. Call ApifyClient("TOKEN").actor("themineworks/google-flights-scraper").call(run_input={"origin": "JFK", "destination": "LAX", "departureDate": "2026-12-15", "maxResults": 50}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: origin, destination (3 letter IATA airport or city codes such as JFK or NYC), departureDate and optional returnDate (YYYY-MM-DD or relative like "+30 days"); routes (list of {origin, destination, departureDate, returnDate}, up to 500 searches); startUrls (Google Flights links with tfs=); adults (1 to 9), children, infantsInSeat, infantsOnLap; cabinClass (economy, premium_economy, business, first); maxStops (any, 0, 1, 2); airlines (list of 2 letter codes); sortBy (best, price, duration, departure, arrival); maxResults (default 100, up to 500 per search); currency (default USD); language (default en); market (country code, default US). Flight rows have no _type field and carry search, origin, destination, departure_date, return_date, trip_type, cabin_class, adults, children, infants_in_seat, infants_on_lap, rank, is_best, price, price_unavailable, currency, price_is_total_for, price_level, typical_price_low, typical_price_high, airline, airlines, airline_codes, flight_numbers, stops, departure_airport, departure_airport_name, departure_time, arrival_airport, arrival_airport_name, arrival_time, duration_minutes, duration, layovers (airport, airport_name, city, duration_minutes, change_of_airport), legs (flight_number, airline, airline_code, operated_by, from, from_name, to, to_name, depart_at, arrive_at, duration_minutes, aircraft, legroom, emissions_kg, also_sold_as), emissions_kg, typical_emissions_kg, emissions_vs_typical_percent, booking_token, booking_url, google_flights_url, results_source, language, market, scraped_at. Times are local to each airport. Prices are the total for all passengers, and for round trips the total for both directions. Each run also writes one row with _type "summary" (per search: lowest_price, price_level, typical range, price_history), one with _type "info" when flights were delivered, and a row with _type "error" for each search that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~google-flights-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **One way and round trip.** A round trip returns the outbound itineraries, each priced at the total for both directions, the way Google Flights lists them.
- **Airport or city codes.** `JFK`, `LHR`, `BOM`, or a city code that groups airports: `NYC` searches JFK, Newark and LaGuardia together, `LON` all London airports.
- **Passengers and cabin.** Up to 9 adults, children, infants in a seat or on a lap; economy, premium economy, business or first. Prices are the total for everyone.
- **Filters Google applies itself.** Nonstop only, 1 stop or fewer, 2 or fewer; a list of airlines to keep. Sort by Google's ranking, price, duration, departure or arrival time.
- **Price insight per search.** `price_level` (low, typical or high), the typical price range for the route and date, and in the summary row the lowest price Google saw on each of the last 60 or so days.
- **A link for every row.** `booking_url` opens that exact itinerary on Google Flights, where the airline and the agencies that sell it are listed. `google_flights_url` opens the whole search.
- **Any currency, language and country.** Prices in your `currency`, names in your `language`, fares as a shopper in `market` sees them.
- **Stops cleanly.** A search Google will not answer gets a free error row; three in a row end the run, so a scheduled run that cannot reach Google stops after a few cheap requests. The run stops before its time limit and keeps every row.

### How to use it

#### One route, one date

```json
{
  "origin": "SFO",
  "destination": "NRT",
  "departureDate": "2027-01-15"
}
```

Up to 100 itineraries, Google's best ranked first (`is_best: true`). Sort the rows by `price` or `duration_minutes`, or filter on `stops` and `airline_codes`.

#### Round trip, business class, a family, one stop at most

```json
{
  "origin": "LON",
  "destination": "NYC",
  "departureDate": "2027-03-10",
  "returnDate": "2027-03-20",
  "adults": 2,
  "children": 1,
  "infantsOnLap": 1,
  "cabinClass": "business",
  "maxStops": "1",
  "currency": "EUR"
}
```

In our test this returned 24 itineraries from Heathrow, Gatwick and London City to JFK and Newark, priced in euros for the whole family, both directions.

#### Fare sweep: one route over several dates

```json
{
  "routes": [
    { "origin": "BOM", "destination": "DEL", "departureDate": "+7 days" },
    { "origin": "BOM", "destination": "DEL", "departureDate": "+8 days" },
    { "origin": "BOM", "destination": "DEL", "departureDate": "+9 days" }
  ],
  "sortBy": "price",
  "maxResults": 20
}
```

Each date is its own search, labelled in `search`. The 20 cheapest per day, and in the summary row the lowest fare and price level of each date.

#### Route map for a travel business

```json
{
  "routes": [
    { "origin": "JFK", "destination": "LHR", "departureDate": "2026-12-20", "returnDate": "2026-12-28" },
    { "origin": "LHR", "destination": "DXB", "departureDate": "2026-12-05", "returnDate": "2026-12-12" },
    { "origin": "SIN", "destination": "SYD", "departureDate": "2026-12-18" },
    { "origin": "CDG", "destination": "FCO", "departureDate": "2027-02-10" }
  ],
  "maxResults": 100
}
```

One run, one start fee, up to 100 itineraries per route.

#### Paste a link from Google Flights

```json
{
  "startUrls": ["https://www.google.com/travel/flights/search?tfs=CBwQAhoeEgoyMDI2LTEyLTE1agcIARIDSkZLcgcIARIDTEFYQAFIAZgBAg&hl=en&curr=USD"]
}
```

Search on google.com/travel/flights and copy the address bar. The route, dates, passengers, cabin and the link's currency are read from it.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `origin` | string | empty | Departure airport or city code, e.g. `JFK`, `NYC` |
| `destination` | string | empty | Arrival airport or city code, e.g. `LAX`, `LON` |
| `departureDate` | string | empty | `YYYY-MM-DD` or relative: `+30 days`, `+7`, `tomorrow` |
| `returnDate` | string | empty | Same formats; makes the search a round trip |
| `routes` | array | empty | More searches: objects with `origin`, `destination`, `departureDate`, `returnDate` |
| `startUrls` | array of strings | empty | Google Flights search links with `tfs=` |
| `adults` | integer | `1` | Passengers aged 12 or over, 1 to 9 |
| `children` | integer | `0` | Aged 2 to 11 |
| `infantsInSeat`, `infantsOnLap` | integer | `0` | Under 2, with a seat or on a lap |
| `cabinClass` | string | `economy` | `economy`, `premium_economy`, `business`, `first` |
| `maxStops` | string | `any` | `any`, `0` (nonstop), `1`, `2` |
| `airlines` | array of strings | empty | Two letter airline codes to keep, e.g. `DL`, `BA` |
| `sortBy` | string | `best` | `best`, `price`, `duration`, `departure`, `arrival` |
| `maxResults` | integer | `100` | Most itineraries per search, 1 to 500 |
| `currency` | string | `USD` | Currency of the prices |
| `language` | string | `en` | Language of airline and airport names |
| `market` | string | `US` | Country of the shopper (point of sale) |
| `proxyConfiguration` | object | Apify Proxy | Leave as is; datacenter IPs are included in the price |

Give one route in the first fields, more in `routes`, links in `startUrls`, or any mix. Up to 500 searches per run.

### What data do you get?

One row per itinerary. Flight rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

| Field | What it is |
|---|---|
| `search` | The search the row answers, e.g. `JFK-LAX 2026-12-15` |
| `origin`, `destination`, `departure_date`, `return_date`, `trip_type` | The route and dates searched; `one_way` or `round_trip` |
| `cabin_class`, `adults`, `children`, `infants_in_seat`, `infants_on_lap` | Cabin and passengers searched |
| `rank`, `is_best` | Place in Google's list, and whether it is one of Google's Top flights |
| `price`, `currency`, `price_is_total_for` | Total price, its currency, and what it covers (all passengers, both directions on a round trip) |
| `price_unavailable` | True when Google lists the flight without a price |
| `price_level`, `typical_price_low`, `typical_price_high` | Google's price insight for the search: low, typical or high, and the typical range |
| `airline`, `airlines`, `airline_codes` | Airline names and codes of the itinerary |
| `flight_numbers` | Flight number of each leg, e.g. `["B6601", "B6201"]` |
| `stops` | 0 for nonstop |
| `departure_airport`, `departure_airport_name`, `departure_time` | First departure, local time `YYYY-MM-DDTHH:MM` |
| `arrival_airport`, `arrival_airport_name`, `arrival_time` | Final arrival, local time |
| `duration_minutes`, `duration` | Total travel time with layovers, e.g. `713` and `11 hr 53 min` |
| `layovers` | Each stop: `airport`, `airport_name`, `city`, `duration_minutes`, `change_of_airport` |
| `legs` | Each flight: `flight_number`, `airline`, `airline_code`, `operated_by`, `from`, `to`, names, `depart_at`, `arrive_at`, `duration_minutes`, `aircraft`, `legroom`, `emissions_kg`, `also_sold_as` |
| `emissions_kg`, `typical_emissions_kg`, `emissions_vs_typical_percent` | CO2 for all passengers in kg, the route's typical, and the difference in percent |
| `booking_token` | Google's token for the itinerary |
| `booking_url` | Google Flights page of this exact itinerary, with who sells it |
| `google_flights_url` | Link that opens the search on Google Flights |
| `results_source` | `api` (Google's results call) or `page` (the results page, used when the call does not answer) |
| `language`, `market`, `scraped_at` | Locale used and when the row was written |

**Summary row** (`_type: "summary"`, never charged): `searches_requested`, `searches_read`, `searches_failed`, `searches_empty`, `itineraries_found`, `flights_delivered`, `charged_for`, `http_requests`, `shortfall_reason` when fewer rows came back than asked, and `per_search`, one entry per search with `flights_found`, `flights_delivered`, `lowest_price`, `price_level`, `typical_price_low`, `typical_price_high`, `price_history` (date and lowest price for about the last 60 days) and why it `stopped`. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per input that is not a valid search (`invalid_input`) and one per search Google did not answer (`blocked`, `fetch_error`), with `identifier` and `reason`.

#### Stable fields for automations

These were present in every flight row of our test runs on Apify (1,953 rows from 35 searches), and their names will not change:

| Field | What it is |
|---|---|
| `search` | The search the row answers |
| `rank` | Place in Google's list |
| `price` | Total price |
| `currency` | Currency of the price |
| `airline` | Airline names |
| `flight_numbers` | Flight number per leg |
| `stops` | Number of stops |
| `departure_time` | Local departure time |
| `arrival_time` | Local arrival time |
| `duration_minutes` | Total travel time |
| `legs` | Leg details |
| `booking_url` | Link to the itinerary |
| `google_flights_url` | Link to the search |

Optional, present only when Google shows a value: `price_level` and the typical range (Google has no insight for some routes), `emissions_kg`, `legroom`, `aircraft`, `operated_by` (only when another airline flies the plane), `also_sold_as` (codeshares), `price` (missing on the few flights Google lists without a fare, which carry `price_unavailable: true`).

#### Output examples

One itinerary from the business class family test (Frankfurt to Bangkok, 2 adults, a child and an infant on lap, prices in EUR, names in German; test run, 12 Nov 2026, trimmed):

```json
{
  "search": "FRA-BKK 2027-01-08",
  "trip_type": "one_way",
  "cabin_class": "business",
  "adults": 2,
  "children": 1,
  "infants_on_lap": 1,
  "rank": 1,
  "is_best": true,
  "price": 6071,
  "currency": "EUR",
  "airline": "Lufthansa, THAI",
  "airline_codes": ["LH", "TG"],
  "flight_numbers": ["LH102", "TG925"],
  "stops": 1,
  "departure_airport": "FRA",
  "departure_time": "2027-01-08T10:15",
  "arrival_airport": "BKK",
  "arrival_time": "2027-01-09T06:10",
  "duration_minutes": 835,
  "duration": "13 hr 55 min",
  "layovers": [{ "airport": "MUC", "airport_name": "Flughafen München", "city": "München", "duration_minutes": 145 }],
  "emissions_kg": 6111,
  "typical_emissions_kg": 6684,
  "emissions_vs_typical_percent": -9
}
```

A nonstop round trip, New York to London, with its codeshares (test run, 12 Nov 2026, trimmed):

```json
{
  "search": "NYC-LON 2026-12-21 / 2026-12-28",
  "trip_type": "round_trip",
  "rank": 1,
  "is_best": true,
  "price": 1317,
  "currency": "USD",
  "price_is_total_for": "all passengers, both directions",
  "price_level": "typical",
  "typical_price_low": 530,
  "typical_price_high": 1050,
  "airline": "United",
  "flight_numbers": ["UA904"],
  "stops": 0,
  "departure_airport": "EWR",
  "departure_time": "2026-12-21T21:00",
  "arrival_airport": "LHR",
  "arrival_time": "2026-12-22T09:10",
  "duration": "7 hr 10 min",
  "legs": [
    { "flight_number": "UA904", "airline": "United", "from": "EWR", "to": "LHR", "depart_at": "2026-12-21T21:00", "arrive_at": "2026-12-22T09:10", "duration_minutes": 430, "aircraft": "Boeing 777", "legroom": "31 in", "emissions_kg": 446, "also_sold_as": ["LH7632", "OS7796", "SN9037"] }
  ],
  "booking_url": "https://www.google.com/travel/flights/booking?tfs=CBwQARo_EgoyMDI2LTEyLTIxIh8KA0VXUhIKMjAyNi0xMi0yMRoDTEhSKgJVQTIDOTA0agcIARIDTllDcgcIARIDTE9OGh4SCjIwMjYtMTItMjhqBwgBEgNMT05yBwgBEgNOWUNAAUgBmAEB&hl=en&gl=US&curr=USD"
}
```

An error row for an input that is not a search (nothing charged):

```json
{ "_type": "error", "error_type": "invalid_input", "identifier": "routes: XX1-LAX 2020-01-01", "reason": "origin \"XX1\" is not a 3 letter IATA airport or city code (for example JFK, LHR, NYC). departureDate 2020-01-01 is in the past." }
```

### Pricing

Pay per event: you pay for the itineraries you receive, plus a flat $0.001 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `flight-scraped` | Once per itinerary row stored in your dataset | $0.90 per 1,000 | $0.81 per 1,000 | $0.72 per 1,000 | $0.63 per 1,000 |
| `run-start` | Once per run, after the first search returned itineraries | $0.001 | $0.001 | $0.001 | $0.001 |

The price of one itinerary is the price per 1,000 divided by 1,000. A search that returns 100 itineraries costs $0.09 on the Free plan; set `maxResults` lower to pay for fewer.

Never charged:

- inputs that are not valid searches (each gets an error row);
- searches Google does not answer, and searches with no flights;
- itineraries past your `maxResults`;
- the summary, info and error rows;
- a run in which no search returned itineraries: the start fee is charged only once a search has returned some;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Users | Price on the Free plan | Start fee | Round trip | Several routes per run | Price level and typical range |
|---|---|---|---|---|---|---|
| **This actor** | new | $0.90 per 1,000 itineraries | $0.001 per run | Yes | Yes, up to 500 | Yes, on every row |
| [Google Flights API](https://apify.com/johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 3,089 | $0.03 per results page; booking options $0.02 each | $0.001 setup per run | Yes | not stated | Yes (stated) |
| [Google Flights Scraper](https://apify.com/lergassy/google-flights-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 1,171 | $1.00 per 1,000 flight rows | $0.001 per run | Yes | Yes | Yes (stated) |
| [Google Flights Scraper, Most Comprehensive](https://apify.com/kaix/google-flights-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | 962 | $0.06 per 1,000 flights, and you pay the platform usage of the run | $0.00005 per GB of memory | Yes | Yes, a batch of 20 | not stated |

Checked 11 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every morning at 07:00, every Monday and so on).
3. Use relative dates (`"+30 days"`) so each run searches the same distance ahead, and compare `price` per `flight_numbers` and `departure_time` between runs to catch fare drops.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works, for example an alert when `price_level` turns `low`.

### FAQ

#### What does this actor read?

Google Flights search results, the same itineraries and prices anyone sees on google.com/travel/flights without logging in. It reads Google's own results data over plain HTTP, no browser, and does not book, hold or buy anything.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key, for Google or anything else. The actor goes through Apify Proxy, which is included. Nothing to set up.

#### How many itineraries does a search return?

All that Google lists for the route and date: about 100 on JFK to LAX, 116 on GRU to EZE, 259 on Mumbai to Delhi and 300 on NYC to LON in our tests. `maxResults` (default 100, up to 500) caps each search. A strict filter (nonstop only, one airline, business class) gives fewer.

#### Are round trip prices per direction or total?

Total for both directions and all passengers. Each row is an outbound itinerary with the round trip price Google shows for it; the return flight is chosen on Google Flights, which `booking_url` opens.

#### What do price_level and the typical range mean?

Google compares the lowest fare for the search with what the route usually costs: `low` is below the typical range, `typical` inside it, `high` above. `typical_price_low` and `typical_price_high` are that range. The summary row has `price_history`, the lowest fare Google saw on each of about the last 60 days.

#### Which codes work?

Any 3 letter IATA airport code Google Flights knows, and city codes that group airports, such as NYC, LON, PAR, TYO, CHI, WAS, MIL, ROM, SAO and YTO. City names such as "London" are not accepted; the error row says which input to fix.

#### How far ahead can I search?

About 330 days, as far as airlines load their fares. A date further out or in the past gets a free error row.

#### How long does a run take?

In our tests: 11 seconds for the "Try it" input, 7 seconds of run time for 10 searches and 1,000 rows, and 36 seconds for 3 searches that included city codes and a business class family round trip. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Why did a search come back with an error row?

Google answers most requests, but now and then refuses one from a given IP. The actor tries other datacenter IPs, then a few residential IPs, and for a one way search also the results page, before it gives up and writes a free error row. Run that search again a few minutes later. In our test runs on Apify, 35 of 35 searches returned itineraries.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has two ready views: Flights, and Legs, layovers and emissions. In CSV and Excel, `legs` and `layovers` are flattened into columns such as `legs/0/flight_number`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/google-flights-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http google-flights-scraper "https://mcp.apify.com/?tools=themineworks/google-flights-scraper"`

#### Is it legal to scrape Google Flights?

The actor reads only public flight listings that anyone can see without logging in, and collects no personal data. You are responsible for how you use the data, including Google's terms of service and the laws that apply to you. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's itineraries to a sheet with Apify's Google Sheets integration; one row per itinerary fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "cheapest nonstop fare for our routes every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a route that returns fewer itineraries than Google Flights shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search Google Flights by route and date and get every itinerary back as one row, with price, airlines, flight numbers, times, stops, layovers, emissions and a booking link, no login.*

# Actor input Schema

## `origin` (type: `string`):

IATA code of the departure airport, for example JFK, LHR or BOM, or a city code that groups several airports, for example NYC, LON or TYO.

## `destination` (type: `string`):

IATA code of the arrival airport or city, for example LAX, CDG, DEL or PAR.

## `departureDate` (type: `string`):

YYYY-MM-DD, for example 2026-12-15, or a date relative to the day of the run: "+30 days", "+7", "tomorrow". Relative dates keep a scheduled run searching the same distance ahead. Google Flights sells up to about 330 days ahead.

## `returnDate` (type: `string`):

Fill it for a round trip, same formats as the departure date ("2026-12-22" or "+37 days"). Round trip rows are the outbound flights, each with the total price for both directions, as Google shows them.

## `routes` (type: `array`):

Several searches in one run, each an object with origin, destination, departureDate and optional returnDate, for example \[{"origin": "JFK", "destination": "LHR", "departureDate": "2026-12-20", "returnDate": "2026-12-28"}, {"origin": "BOM", "destination": "DXB", "departureDate": "+14 days"}]. Passengers, cabin, stops and the other settings below apply to every route. Up to 500 searches per run.

## `startUrls` (type: `array`):

Search links copied from your browser after a search on google.com/travel/flights, the ones with tfs= in them, for example https://www.google.com/travel/flights/search?tfs=CBwQAhoeEgoyMDI2LTEyLTE1agcIARIDSkZLcgcIARIDTEFYQAFIAZgBAg. The route, dates, passengers and cabin are read from the link.

## `adults` (type: `integer`):

Passengers aged 12 or over. Prices are the total for all passengers.

## `children` (type: `integer`):

Children aged 2 to 11.

## `infantsInSeat` (type: `integer`):

Infants under 2 with their own seat.

## `infantsOnLap` (type: `integer`):

Infants under 2 on an adult's lap (at most one per adult).

## `cabinClass` (type: `string`):

Seat class to search.

## `maxStops` (type: `string`):

Most stops per direction. Google applies it on its side, so the search itself returns only those flights.

## `airlines` (type: `array`):

Two letter airline codes to keep, for example DL, AA, BA. Google applies it on its side. Alliances work too: STAR_ALLIANCE, ONEWORLD, SKYTEAM. Empty means every airline.

## `sortBy` (type: `string`):

Order of the rows. Best is Google's own ranking (its "Top flights" first, marked is_best).

## `maxResults` (type: `integer`):

The most itineraries to return for each route and date, 1 to 500. A busy route has 100 to 300.

## `currency` (type: `string`):

Three letter currency code for the prices, for example USD, EUR, GBP, INR. Google converts the prices.

## `language` (type: `string`):

Language code for airline and airport names, for example en, de, fr, es, hi.

## `market` (type: `string`):

Two letter country code of the shopper, for example US, GB, IN, DE. Fares and sellers can differ by country.

## `proxyConfiguration` (type: `object`):

Apify Proxy is on by default (datacenter IPs, included in the price). If Google stops answering from datacenter IPs, the actor tries a few residential IPs by itself before it gives up on a search. You can pick another group here.

## Actor input object example

```json
{
  "origin": "JFK",
  "destination": "LAX",
  "departureDate": "+30 days",
  "adults": 1,
  "children": 0,
  "infantsInSeat": 0,
  "infantsOnLap": 0,
  "cabinClass": "economy",
  "maxStops": "any",
  "sortBy": "best",
  "maxResults": 30,
  "currency": "USD",
  "language": "en",
  "market": "US",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "origin": "JFK",
    "destination": "LAX",
    "departureDate": "+30 days",
    "maxResults": 30,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/google-flights-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "origin": "JFK",
    "destination": "LAX",
    "departureDate": "+30 days",
    "maxResults": 30,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/google-flights-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "origin": "JFK",
  "destination": "LAX",
  "departureDate": "+30 days",
  "maxResults": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/google-flights-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/google-flights-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sO8KiYqy48Rf4AVhC/builds/WMsGqc0e5QjrU0bdm/openapi.json
