# Google Flights Scraper - Live Fares, Cheap Flights & Portals (`dev00/google-flights-scraper-api`) Actor

Extract real-time Google Flights itineraries, live airfares, baggage fees, explore anywhere destinations by continent, direct booking links, and lowest-price calendar matrices.

- **URL**: https://apify.com/dev00/google-flights-scraper-api.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Categories:** Travel, Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 flight itinerary leads

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## ✈️ Google Flights Scraper - Live Fares, Cheap Flights, Explore Destinations & Portals

> 🚀 **The #1 Most Complete, Real-Time Google Flights Search, Continental Destination Explorer & Price Intelligence Scraper on Apify.**

Looking for reliable, low-latency live airfares, flight itineraries across 500+ global airlines, baggage fee calculations, and destination discovery without maintaining expensive GDS certifications or complex browser automation?

The **Google Flights Scraper** delivers real-time flight shopping results, round-trip and one-way itineraries, passenger breakdowns (adults, children, infants), baggage fee calculators, **Explore Destinations ("Explore Anywhere") across continents with selectable travel dates**, carbon emission footprints, and direct booking links directly from Google Flights.

***

### 🌟 Why This Actor Outperforms Competitors

| Capability | Generic Flight Scrapers | Official GDS / APIs | ✈️ Google Flights Scraper |
| :--- | :---: | :---: | :---: |
| **Real-Time Live Airfares** | ⚠️ Cached / Stale Data | ⚠️ GDS Certification Req. | ✅ **Live Real-Time Extraction (~250ms)** |
| **Explore Anywhere (Continent Map)** | ❌ No | ⚠️ Very Complex | ✅ **Explore by Europe, America, Asia, Africa, etc.** |
| **Selectable Travel Dates for Explore** | ❌ No | ❌ No | ✅ **Custom Departure/Return Dates or Flexible Windows** |
| **Direct Airline Booking Links** | ❌ No | ⚠️ OTA Heavy | ✅ **Official Airline Websites + Expedia + Booking.com** |
| **Children & Infants Breakdown** | ⚠️ Adults Only | ⚠️ Limited | ✅ **Adults, Children (2-11), Infants In Seat / On Lap** |
| **Baggage Fee Calculator** | ❌ No | ⚠️ Hidden Add-on Fees | ✅ **Carry-On & Checked Luggage Fee Breakdown** |
| **Cabin Classes Supported** | ⚠️ Economy Only | ⚠️ Limited | ✅ **Economy, Premium Economy, Business, First Class** |
| **CO2 Carbon Emission Tracking** | ❌ No | ⚠️ Rare | ✅ **Carbon Footprint (kg CO2 & Route Comparison)** |
| **Input Format** | ⚠️ Complex JSON Arrays | ⚠️ Heavy Payload | ✅ **Simple Direct Input (No JSON needed)** |
| **Pricing Model** | 💸 High Monthly Subscriptions | 💸 Custom Enterprise Contracts | ⚡ **Pay-Per-Event ($0.005 / flight lead)** |

***

### ⚡ Comprehensive Feature Breakdown

#### 1. ✨ AI Semantic Flight Deals & Travel Vibe Search

Unlock intelligent natural language deal discovery. Simply enter travel desires in plain English:

- *"Week-long trip to a city with great food"*
- *"Romantic beach weekend getaway near warm turquoise water"*
- *"Alpine skiing and winter mountain retreats under $400"*
- *"Cultural discovery with ancient temples, historic museums, and architecture"*
- *"Vibrant nightlife, live electronic music, and weekend clubbing"*
- *"Budget-friendly hidden gem European capitals under $200"*

The AI engine matches destinations, calculates flight durations and round-trip airfares, highlights why it matches, provides top 3 curated local experiences, computes discount badges (e.g. `32% CHEAPER THAN USUAL`), and generates direct Google Flights deal URLs!

#### 2. 🔍 Single Flight Shopping (Round-Trip & One-Way)

Search real-time flight options for single routes. Filter by:

- **Travel Dates**: Exact departure date and return date (`YYYY-MM-DD`).
- **Passenger Breakdown**: Detailed counts for adults (12+), children (age 2–11 with automated discount calculation), infants in seat, and infants on lap.
- **Baggage Calculator**: Carry-on luggage items and checked baggage count with transparent fee breakdown.
- **Cabin Classes**: Economy, Premium Economy, Business Class (Lie-flat seats), and First Class.
- **Stops & Layovers**: Non-stop only (`maxStops="0"`), up to 1 stop, up to 2 stops, with layover airports and duration.
- **Budget Caps**: Filter out flights above your budget (`maxPrice`).

#### 3. 🌍 Explore Anywhere & Continental Discovery

Discover the cheapest destinations worldwide or within specific continents from any origin airport:

- **Supported Continents / Regions**:
  - `Anywhere (Worldwide)`
  - `Europe` *(London, Paris, Rome, Barcelona, Amsterdam, Madrid, Lisbon, Vienna, Prague, Athens, Berlin, Dublin)*
  - `North America / USA` *(New York, Los Angeles, Miami, San Francisco, Las Vegas, Chicago, Toronto, Cancun)*
  - `Asia` *(Tokyo, Singapore, Bangkok, Seoul, Bali, Hong Kong, New Delhi)*
  - `Middle East` *(Dubai, Doha, Istanbul, Riyadh)*
  - `Africa` *(Casablanca, Marrakech, Cairo, Cape Town, Nairobi)*
  - `South America` *(Rio de Janeiro, Buenos Aires, Bogota, Lima)*
  - `Oceania / Australia` *(Sydney, Melbourne, Auckland)*
- **Date Selectable**: Choose exact departure/return travel dates or flexible travel periods (`1_week`, `2_weeks`, `weekend`, `anytime`).
- **Rich Content**: Returns destination city, country, IATA airport code, lowest ticket price, flight duration, stops, thumbnail photo URL, top attractions, and Google Flights Explore map link.

#### 3. 🎫 Direct Airline & OTA Booking Redirects

Every itinerary includes direct booking URLs to official airline portals as well as major online travel agencies (Expedia, Booking.com) and Google Flights shareable search links.

#### 4. 🌱 Carbon Footprint (CO2 Emissions)

Track flight carbon footprints (kg CO2) and percentage comparisons against typical route averages, with eco-friendly `LOW_EMISSION` ratings.

***

### 📥 Input Configuration Parameters

| Parameter | Type | Default | Description |
| :--- | :---: | :---: | :--- |
| `origin` | `string` | `"CDG"` | Departure airport IATA code (e.g. `CDG`, `JFK`, `LHR`, `CMN`, `DXB`). |
| `destination` | `string` | `"STN"` | Arrival airport code (e.g. `STN`, `MIA`, `LHR`) or `"anywhere"` to explore destinations. |
| `region` | `string` | `"anywhere"` | Continent filter for Explore mode: `anywhere`, `Europe`, `North America`, `Asia`, `Africa`, `Middle East`, `South America`, `Oceania`. |
| `tripType` | `string` | `"round_trip"` | Trip type: `round_trip` or `one_way`. |
| `departureDate` | `string` | `"2026-09-01"` | Departure date in `YYYY-MM-DD` format. |
| `returnDate` | `string` | `"2026-09-10"` | Optional return date for round-trip flights. |
| `travelPeriod` | `string` | `"1_week"` | Flexible duration for explore mode: `1_week`, `2_weeks`, `weekend`, `anytime`. |
| `adults` | `integer` | `1` | Number of adult passengers (age 12+). |
| `children` | `integer` | `0` | Number of child passengers (age 2–11). |
| `infantsInSeat` | `integer` | `0` | Infants occupying their own seat (under 2). |
| `infantsOnLap` | `integer` | `0` | Infants held on lap (under 2). |
| `carryOnBags` | `integer` | `0` | Carry-on bags per passenger (0–2). |
| `checkedBags` | `integer` | `0` | Checked bags per passenger (0–2). |
| `cabinClass` | `string` | `"economy"` | Seating cabin class: `economy`, `premium_economy`, `business`, `first`. |
| `maxStops` | `string` | `"any"` | Stops filter: `any`, `0` (Non-stop only), `1` (Up to 1 stop), `2` (Up to 2 stops). |
| `maxPrice` | `integer` | `null` | Maximum total airfare budget per itinerary. |
| `currency` | `string` | `"USD"` | Currency code (`USD`, `EUR`, `GBP`, `MAD`, `CAD`, `AUD`, `JPY`, etc.). |
| `maxItineraries` | `integer` | `20` | Maximum number of flight itineraries to extract. |

***

### 📤 Output Dataset Example

#### Flight Itinerary Record:

```json
{
  "itinerary_id": "itinerary_2bfc1d0f",
  "type": "ROUND_TRIP",
  "route": "CDG ➔ STN",
  "airline_names": ["Air France"],
  "airline_logos": ["https://www.gstatic.com/flights/airline_logos/70px/AF.png"],
  "passengers_breakdown": {
    "adults": 2,
    "children": 1,
    "infants_in_seat": 0,
    "infants_on_lap": 0,
    "total_passengers": 3
  },
  "baggage": {
    "carry_on_bags": 2,
    "checked_bags": 1,
    "baggage_fees_total": 390,
    "formatted_baggage_fees": "$390"
  },
  "price": {
    "raw": "$779",
    "amount": 779,
    "base_airfare": 389,
    "currency": "USD",
    "currency_symbol": "$",
    "is_best_price": true
  },
  "duration_minutes": 85,
  "duration_human": "1h 25m",
  "stops_count": 0,
  "stops_description": "Non-stop",
  "layovers": [],
  "carbon_emissions": {
    "footprint_kg": 95,
    "vs_route_average_percent": -18,
    "rating": "LOW_EMISSION"
  },
  "outbound_flight": [
    {
      "airline_name": "Air France",
      "airline_iata": "AF",
      "flight_number": "AF 100",
      "aircraft_type": "Airbus A321neo",
      "departure_airport": { "iata": "CDG", "name": "Charles de Gaulle Airport", "city": "Paris" },
      "departure_time": "2026-09-01T06:00:00",
      "arrival_airport": { "iata": "STN", "name": "London Stansted Airport", "city": "London" },
      "arrival_time": "2026-09-01T07:25:00",
      "duration_human": "1h 25m",
      "legroom": "30 inches",
      "cabin_class": "ECONOMY"
    }
  ],
  "booking_options": [
    {
      "provider_name": "Air France Direct",
      "price": "$779",
      "is_airline_direct": true,
      "booking_url": "https://www.google.com/travel/flights?q=flights+from+CDG+to+STN"
    },
    {
      "provider_name": "Expedia",
      "price": "$784",
      "is_airline_direct": false,
      "booking_url": "https://www.expedia.com/Flights-Search"
    }
  ],
  "google_flights_url": "https://www.google.com/travel/flights?q=flights+from+CDG+to+STN+on+2026-09-01"
}
```

#### Destination Discovery Record (Explore Anywhere):

```json
{
  "mode": "EXPLORE_DESTINATION",
  "origin": "CDG",
  "destination_city": "Rome",
  "destination_country": "Italy",
  "destination_iata": "FCO",
  "region": "Europe",
  "travel_dates": {
    "departure_date": "2026-09-01",
    "return_date": "2026-09-10",
    "travel_period": "1_week"
  },
  "thumbnail_url": "https://images.unsplash.com/photo-1552832230-c0197dd311b5?w=600",
  "top_attractions": ["Colosseum", "Trevi Fountain", "Vatican Museums"],
  "price": {
    "raw": "$65",
    "amount": 65,
    "currency": "USD"
  },
  "explore_url": "https://www.google.com/travel/explore?origin=CDG&dest=FCO",
  "google_flights_url": "https://www.google.com/travel/flights?q=flights+from+CDG+to+FCO+on+2026-09-01"
}
```

***

### 🎯 Top High-Growth Use Cases

1. **Online Travel Agencies & Metasearch Engines**: Build complete flight booking engines with live fares and direct provider redirects.
2. **"Explore Anywhere" Vacation Planners**: Power interactive map-based destination discovery tools helping users find affordable getaways within their budget.
3. **Flight Price Drop & Deal Alert Bots**: Monitor high-demand flight routes and notify newsletter subscribers or Telegram channels when prices drop.
4. **Corporate Travel & Expense Management**: Automate flight budget tracking and find optimal business-class lie-flat itineraries.
5. **AI Travel Agents & Itinerary Builders**: Integrate real-time flight shopping into AI travel agents and automated trip planners.

***

### 💻 Integration Code Snippets

#### Python (`apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "origin": "CDG",
    "destination": "STN",
    "tripType": "round_trip",
    "departureDate": "2026-09-01",
    "returnDate": "2026-09-10",
    "adults": 2,
    "children": 1,
    "carryOnBags": 2,
    "checkedBags": 1,
    "currency": "USD",
    "maxItineraries": 20
}

run = client.actor("dev00/google-flights-scraper-api").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Flight: {item['route']} | Price: {item['price']['raw']} | Airline: {item['airline_names']}")
```

#### Node.js (`apify-client`):

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
  origin: 'CDG',
  destination: 'anywhere',
  region: 'Europe',
  departureDate: '2026-09-01',
  returnDate: '2026-09-10',
  currency: 'USD'
};

const run = await client.actor('dev00/google-flights-scraper-api').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(`Extracted ${items.length} destination deals!`);
console.log(items[0]);
```

***

### 💰 Pay-Per-Event (PPR) Pricing Model

This Actor operates under the transparent **Pay-Per-Event** monetization model:

- **Price**: **$0.005 per flight itinerary lead** ($5.00 per 1,000 extracted itineraries).
- **No Monthly Minimums**: Only pay for the exact volume of flight leads you extract.

***

### ❓ Frequently Asked Questions (FAQ)

##### Q: How fresh is the flight pricing data?

All search queries extract real-time live airfares directly from Google Flights with zero stale caching.

##### Q: Can I search for flights without specifying an arrival city?

Yes! Simply set `destination: "anywhere"` and choose your desired `region` (`Europe`, `North America`, `Asia`, `Africa`, `Middle East`, etc.) to discover the cheapest flight destinations.

##### Q: Are baggage fees and child passenger discounts included?

Yes. The Actor supports carry-on and checked luggage calculators and automatically applies child passenger discount fare rules.

##### Q: How do I handle currencies other than USD?

Simply pass the `currency` parameter (e.g. `currency="EUR"`, `currency="GBP"`, `currency="MAD"`, `currency="CAD"`).

***

### 🔍 Search Keywords & SEO Tags

`google flights api`, `google flights scraper`, `flight search api`, `cheap flights scraper`, `airfare scraper`, `live flight prices`, `airline tickets api`, `explore anywhere flights`, `flight calendar matrix`, `travel api`, `skyscanner alternative`, `amadeus alternative`, `kiwi api alternative`, `expedia api alternative`, `flight booking links`, `flight price tracker`, `round trip flights api`, `one way flights api`, `baggage fee calculator api`, `flight price drop alert`, `international flights api`, `domestic flights api`, `airport autocomplete api`, `iata code lookup`, `flight delay tracker`, `business class flight deals`, `low cost airlines api`, `ryanair flights api`, `easyjet flights api`, `air france flights api`, `delta flights api`, `united airlines api`, `american airlines api`, `emirates flights api`, `qatar airways api`, `flight co2 emissions calculator`, `travel metasearch api`, `flight fare aggregator`, `vacation finder api`, `holiday flight deals`, `weekend getaway flight search`, `last minute flights scraper`, `multi city flights api`, `flight booking engine api`, `flight price history insights`, `best time to book flights api`, `travel bot api`, `ai travel agent flight scraper`, `hotel and flights api`, `tourism data api`, `global airline schedules`

# Actor input Schema

## `aiPrompt` (type: `string`):

Natural language travel intent (e.g. 'Week-long trip to a city with great food', 'Romantic beach getaway', 'Skiing in the Alps', 'Cultural history and ancient temples'). Leave empty for standard route search.

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

Departure airport IATA code (e.g. CDG, JFK, LHR, CMN, DXB).

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

Arrival airport IATA code (e.g. STN, LHR, MIA) or type 'anywhere' to explore destinations.

## `region` (type: `string`):

Filter destination discovery by continent or region.

## `tripType` (type: `string`):

Select round-trip or one-way flight.

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

Departure date in YYYY-MM-DD format (e.g. 2026-09-01).

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

Return date in YYYY-MM-DD format (e.g. 2026-09-10). Ignored if trip type is One Way.

## `travelPeriod` (type: `string`):

Travel duration length for flexible destination search.

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

Number of adult passengers.

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

Number of child passengers.

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

Number of infants occupying their own seat.

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

Number of infants held on lap.

## `carryOnBags` (type: `integer`):

Number of carry-on bags per passenger.

## `checkedBags` (type: `integer`):

Number of checked bags per passenger.

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

Seating cabin class tier.

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

Filter flight itineraries by maximum number of stops.

## `maxPrice` (type: `integer`):

Maximum total airfare budget per itinerary.

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

Currency code for airfare display (e.g. USD, EUR, GBP, MAD, CAD).

## `maxItineraries` (type: `integer`):

Maximum number of flight itineraries to extract.

## Actor input object example

```json
{
  "origin": "CDG",
  "destination": "STN",
  "region": "anywhere",
  "tripType": "round_trip",
  "departureDate": "2026-09-01",
  "returnDate": "2026-09-10",
  "travelPeriod": "1_week",
  "adults": 1,
  "children": 0,
  "infantsInSeat": 0,
  "infantsOnLap": 0,
  "carryOnBags": 0,
  "checkedBags": 0,
  "cabinClass": "economy",
  "maxStops": "any",
  "currency": "USD",
  "maxItineraries": 20
}
```

# Actor output Schema

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

Direct link to the dataset items containing extracted flight records

## `keyValueStoreResult` (type: `string`):

Direct link to the key-value store output record

# 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 = {
    "aiPrompt": "",
    "origin": "CDG",
    "destination": "STN",
    "departureDate": "2026-09-01",
    "returnDate": "2026-09-10"
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/google-flights-scraper-api").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 = {
    "aiPrompt": "",
    "origin": "CDG",
    "destination": "STN",
    "departureDate": "2026-09-01",
    "returnDate": "2026-09-10",
}

# Run the Actor and wait for it to finish
run = client.actor("dev00/google-flights-scraper-api").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 '{
  "aiPrompt": "",
  "origin": "CDG",
  "destination": "STN",
  "departureDate": "2026-09-01",
  "returnDate": "2026-09-10"
}' |
apify call dev00/google-flights-scraper-api --silent --output-dataset

```

## MCP server setup

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

```

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/la0hqu0AiQOvAlX7h/builds/T4I3hEm7GfMVNefEv/openapi.json