# Google Flights Scraper (`curious_coder/google-flights-scraper`) Actor

$0.1 per 1k. Search and scrape Google flights and export full details including prices, booking links and more.

- **URL**: https://apify.com/curious_coder/google-flights-scraper.md
- **Developed by:** [Curious Coder](https://apify.com/curious_coder) (community)
- **Categories:** Travel
- **Features:** Limited permissions
- **Stats:** 25 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.10 / 1,000 results

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

Search **Google Flights** for any route and get the results as clean, structured data — prices, airlines, departure and arrival times, flight duration, number of stops, layovers, aircraft, and estimated CO₂ emissions.

Perfect for price monitoring, travel dashboards, fare alerts, market research, or feeding flight data into your own app or spreadsheet.

***

### What you can do

- 🔎 Search **one-way** and **round-trip** flights for any route and date
- 💸 Get **live prices** in the currency of your choice
- 🛫 See **airlines, flight numbers, schedules, duration and stops**
- 🧳 Filter by **cabin class** (economy, premium economy, business, first)
- 🚏 Filter by **number of stops** (nonstop, 1 stop, 2 stops, or any)
- 👨‍👩‍👧 Search for **multiple passengers** (adults, children, infants)
- 🌍 Choose your **currency, language and country**

***

### Input

You only need three things to get started: **where from**, **where to**, and **when**.

| Field | Description | Example |
|-------|-------------|---------|
| **From (origin)** | Departure airport code | `JFK` |
| **To (destination)** | Arrival airport code | `LAX` |
| **Departure date** | Outbound date (`YYYY-MM-DD`) | `2026-07-30` |
| **Return date** | Return date — leave empty for one-way | `2026-08-06` |
| **Adults / Children / Infants** | Number of passengers | `1` |
| **Cabin class** | Economy, Premium economy, Business, First | `Economy` |
| **Stops** | Any, Nonstop, 1 stop or fewer, 2 stops or fewer | `Any` |
| **Currency** | Currency for prices | `USD` |
| **Language / Country** | Locale for results | `en` / `us` |
| **Maximum results** | Limit how many flights to save | `50` |
| **Include vendor booking links** | Fetch airline/OTA booking URLs (extra API call per flight) | `false` |
| **Include price calendar** | Embed flexible-date prices in each flight record | `false` |
| **Calendar start / end date** | Custom window for the price calendar | optional |

> 💡 **Tip:** Airports are entered as their 3-letter codes (for example `JFK`, `LHR`, `DXB`, `SIN`). You can also paste a full Google Flights link into the **Google Flights link** field and the actor will read the route and dates from it automatically.

#### Example input

```json
{
  "origin": "JFK",
  "destination": "LHR",
  "departureDate": "2026-07-30",
  "returnDate": "2026-08-06",
  "adults": 1,
  "cabinClass": "economy",
  "stops": "nonstop",
  "currency": "USD"
}
```

***

### Output

Each result is one flight option. When **Include price calendar** is enabled, every flight record also includes a `priceCalendar` array with flexible-date prices for the same route.

```json
{
  "price": 285,
  "currency": "USD",
  "airlines": ["British Airways"],
  "primaryAirlineName": "British Airways",
  "resultTier": "best",
  "departureAirport": "JFK",
  "departureTime": "07:50",
  "departureDate": "2026-07-30",
  "arrivalAirport": "LHR",
  "arrivalTime": "19:45",
  "arrivalDate": "2026-07-30",
  "duration": "6h 55m",
  "stops": 0,
  "co2EmissionsGrams": 424000,
  "co2EmissionsTypicalGrams": 410000,
  "co2EmissionsDeltaPercent": -3,
  "emissionsTag": "lower",
  "bookingLink": "https://www.google.com/travel/flights/booking?tfs=...",
  "searchLink": "https://www.google.com/travel/flights?q=...",
  "departureToken": "W1siQkEiLCIyMDI2...",
  "travelAdvisories": [{ "title": "Travel restricted", "message": "..." }],
  "baggagePolicyLinks": [{ "airlineCode": "BA", "url": "https://..." }],
  "priceCalendar": [
    {
      "departureDate": "2026-08-01",
      "returnDate": null,
      "price": 209,
      "currency": "USD",
      "isLowPrice": true
    }
  ],
  "segments": [
    {
      "flightNumber": "BA 178",
      "airlineCode": "BA",
      "extensions": ["Average legroom (31 in)", "Wi-Fi"],
      "amenities": { "wifi": true, "power": true }
    }
  ],
  "layovers": [{ "airport": "ORD", "changeOfAirport": true, "duration": "2h 10m" }]
}
```

When **Include vendor booking links** is enabled, records also include `bookingOptions` (vendor fares with `bookingLink`, `googleClickLink`, `fareName`, `fareCode`) and `vendorBookingLink`.

For flights with stops, the `segments` array lists each leg of the journey and `layovers` describes each connection (airport, city and waiting time).

You can export the results as **JSON, CSV, Excel, HTML or XML** from the **Storage** tab, or pull them through the Apify API.

***

### Notes

- For **round-trip** searches, results show the available outbound flights together with the lowest total round-trip price — exactly as Google Flights presents them.
- Prices are provided by Google and can change at any time. Always confirm the final price with the airline or booking site before purchasing.
- This actor is not affiliated with or endorsed by Google.

***

### FAQ

**Which airports can I search?**
Any airport or metro area supported by Google Flights. Use the standard 3-letter airport code.

**Can I monitor prices automatically?**
Yes. Use Apify **Schedules** to run the actor on a recurring basis and combine it with integrations (email, Slack, webhooks) to get alerts when prices change.

**Do I need to configure anything else?**
No. Just enter your route and dates and run it.

# Changelog

This Actor's version history is a separate document: https://apify.com/curious_coder/google-flights-scraper/changelog.md

# Actor input Schema

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

Departure airport or city. Use a 3-letter airport code such as <b>JFK</b>, <b>LHR</b> or <b>DXB</b>.

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

Arrival airport or city. Use a 3-letter airport code such as <b>LAX</b>, <b>CDG</b> or <b>SIN</b>.

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

Date of the outbound flight in <b>YYYY-MM-DD</b> format.

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

Date of the return flight in <b>YYYY-MM-DD</b> format. Leave empty for a one-way trip.

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

Number of adult passengers.

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

Number of children (2-11 years).

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

Number of infants occupying their own seat.

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

Number of infants travelling on a lap.

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

Preferred travel class.

## `stops` (type: `string`):

Maximum number of stops.

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

Currency for prices, e.g. <b>USD</b>, <b>EUR</b>, <b>GBP</b>, <b>INR</b>.

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

Two-letter language code for results, e.g. <b>en</b>.

## `country` (type: `string`):

Two-letter country code used for search context, e.g. <b>us</b>.

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

Limit the number of flights saved. Leave empty to save all results.

## `searchUrl` (type: `string`):

Alternatively, paste a full Google Flights link here and the actor will read the route and dates from it.

## `includeBookingOptions` (type: `boolean`):

When enabled, fetches airline and OTA booking links for each flight (one extra API call per result). The <b>bookingLink</b> field is always included without this option.

## `includePriceCalendar` (type: `boolean`):

When enabled, fetches flexible-date prices and embeds them in each flight record as a <b>priceCalendar</b> array.

## `calendarStartDate` (type: `string`):

Start of the price calendar window (<b>YYYY-MM-DD</b>). Defaults to 15 days before the departure date.

## `calendarEndDate` (type: `string`):

End of the price calendar window (<b>YYYY-MM-DD</b>). Defaults to 15 days after the departure date.

## Actor input object example

```json
{
  "origin": "JFK",
  "destination": "LAX",
  "departureDate": "2026-07-30",
  "returnDate": "2026-08-06",
  "adults": 1,
  "children": 0,
  "infantsInSeat": 0,
  "infantsOnLap": 0,
  "cabinClass": "economy",
  "stops": "any",
  "currency": "USD",
  "language": "en",
  "country": "us",
  "includeBookingOptions": false,
  "includePriceCalendar": false,
  "calendarStartDate": "2026-07-01",
  "calendarEndDate": "2026-08-15"
}
```

# Actor output Schema

## `flights` (type: `string`):

One item per flight option, including price, currency, airlines, departure and arrival airports/times, total duration, number of stops, per-leg segments, layovers, CO2 estimates and a Google Flights booking link.

# 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": "2026-07-30",
    "adults": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("curious_coder/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": "2026-07-30",
    "adults": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("curious_coder/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": "2026-07-30",
  "adults": 1
}' |
apify call curious_coder/google-flights-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,curious_coder/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/eeKzmgfTEVfeUYT8k/builds/lopFKU5BDLkZvjUFb/openapi.json