# Google Flights Scraper (`zerobreak/google-flights-scraper`) Actor Google Flights scraper that collects itineraries, prices, airlines, durations, layovers, and carbon emissions for any route and date, so you can monitor fares, compare options, and build travel price trackers. - **URL**: https://apify.com/zerobreak/google-flights-scraper.md - **Developed by:** [ZeroBreak](https://apify.com/zerobreak) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 60.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Pulls flight itineraries from Google Flights into a structured dataset. Useful for price monitoring, travel research, route analysis, and building fare comparison tools. ### What it does Search any route by airport IATA codes and date. Returns best flights and other available flights with full details: price, airlines, departure and arrival times, duration, layovers, cabin class, legroom, carbon emissions, and price insights. ### Example use cases - Monitor flight prices for a route over time - Find the cheapest or fastest options for a trip - Compare nonstop vs. connecting flight prices - Research carbon emissions by route - Build a travel price tracker or fare alert tool ### Input | Field | Description | Default | |-------|-------------|---------| | `departureId` | Origin IATA code (e.g., "JFK", "LHR", "IST"). Comma-separate for multi-airport (e.g., "JFK,LGA,EWR") | required | | `arrivalId` | Destination IATA code. Multi-airport supported | required | | `outboundDate` | Departure date in YYYY-MM-DD format | required | | `returnDate` | Return date (YYYY-MM-DD). Required for round trips | — | | `tripType` | 1=Round trip, 2=One way | `2` | | `adults` | Adult passengers (1–9) | `1` | | `children` | Child passengers (0–9) | `0` | | `travelClass` | 1=Economy, 2=Premium economy, 3=Business, 4=First | `1` | | `stops` | 0=Any, 1=Nonstop, 2=Max 1 stop, 3=Max 2 stops | `0` | | `sortBy` | 1=Top, 2=Price, 3=Departure, 4=Arrival, 5=Duration, 6=Emissions | `1` | | `includeAirlines` | Show only these airlines (comma-separated IATA, e.g., "DL,AA") | — | | `excludeAirlines` | Hide these airlines (comma-separated IATA, e.g., "F9,NK") | — | | `currency` | Price currency code (e.g., "USD", "EUR", "GBP", "TRY") | `USD` | | `language` | Language code (e.g., "en", "de", "tr") | `en` | | `country` | Country code (e.g., "us", "gb") | `us` | | `maxItems` | Max itineraries to return | `20` | | `requestTimeoutSecs` | Per-request timeout | `30` | #### Example input — one way ```json { "departureId": "JFK", "arrivalId": "LAX", "outboundDate": "2025-09-15", "tripType": 2, "adults": 1, "travelClass": 1, "stops": 1, "sortBy": 2, "currency": "USD", "maxItems": 30 } ```` #### Example input — round trip ```json { "departureId": "LHR", "arrivalId": "JFK", "outboundDate": "2025-10-01", "returnDate": "2025-10-10", "tripType": 1, "adults": 2, "travelClass": 3, "currency": "GBP", "maxItems": 20 } ``` ### Output Each itinerary is one dataset record: | Field | Description | |-------|-------------| | `rank` | Position in results (1-based) | | `isBestFlight` | True if Google marked it as a best flight | | `flightType` | "One way" or "Round trip" | | `price` | Total price (numeric) | | `currency` | Currency code | | `totalDurationMins` | Total journey time in minutes | | `stopCount` | Number of layovers | | `airlines` | List of airlines operating the flight | | `airlineLogo` | Primary airline logo URL | | `bookingToken` | Google booking token | | `departureToken` | Token for fetching return leg separately | | `legs` | Array of flight leg objects (see below) | | `layovers` | Array of layover objects | | `carbonEmissionsGrams` | CO2 for this flight (grams) | | `carbonEmissionsTypicalGrams` | Typical CO2 for this route (grams) | | `carbonEmissionsDiffPercent` | % difference vs. typical | | `lowestPrice` | Lowest price seen for this route | | `priceLevel` | "low", "typical", or "high" | | `typicalPriceRangeMin` / `typicalPriceRangeMax` | Typical price range | | `searchRoute` | Route string (e.g., "JFK -> LAX") | | `outboundDate` | Searched outbound date | | `returnDate` | Searched return date (null if one way) | | `scrapedAt` | ISO 8601 timestamp | #### Leg object fields | Field | Description | |-------|-------------| | `departureAirportCode` | IATA code | | `departureAirportName` | Full airport name | | `departureTime` | Datetime string (YYYY-MM-DD HH:MM) | | `arrivalAirportCode` | IATA code | | `arrivalAirportName` | Full airport name | | `arrivalTime` | Datetime string | | `durationMins` | Leg duration in minutes | | `airline` | Airline name | | `airlineLogo` | Airline logo URL | | `flightNumber` | Flight number (e.g., "DL 123") | | `airplane` | Aircraft type (e.g., "Boeing 737") | | `travelClass` | Cabin class string | | `legroom` | Legroom info (e.g., "31 in") | | `isOvernight` | True if flight crosses midnight | | `extensions` | Feature badges (e.g., "Wi-Fi", "In-seat power") | #### Layover object fields | Field | Description | |-------|-------------| | `airportCode` | IATA code | | `airportName` | Airport name | | `durationMins` | Layover duration in minutes | #### Example output ```json { "rank": 1, "isBestFlight": true, "flightType": "One way", "price": 149, "currency": "USD", "totalDurationMins": 356, "stopCount": 0, "airlines": ["Delta"], "airlineLogo": "https://www.gstatic.com/flights/airline_logos/...", "legs": [ { "departureAirportCode": "JFK", "departureAirportName": "John F. Kennedy International Airport", "departureTime": "2025-09-15 08:00", "arrivalAirportCode": "LAX", "arrivalAirportName": "Los Angeles International Airport", "arrivalTime": "2025-09-15 11:56", "durationMins": 356, "airline": "Delta", "flightNumber": "DL 487", "airplane": "Boeing 757", "travelClass": "Economy", "legroom": "31 in", "isOvernight": false, "extensions": ["Wi-Fi for a fee", "In-seat power outlet"] } ], "layovers": [], "carbonEmissionsGrams": 126000, "carbonEmissionsTypicalGrams": 126000, "carbonEmissionsDiffPercent": 0, "lowestPrice": 149, "priceLevel": "low", "typicalPriceRangeMin": 180, "typicalPriceRangeMax": 320, "searchRoute": "JFK -> LAX", "outboundDate": "2025-09-15", "returnDate": null, "scrapedAt": "2025-06-01T14:32:00+00:00" } ``` ### Notes - Results include both "best flights" (`isBestFlight: true`) and other available flights - `stopCount` is derived from the number of layover entries - `carbonEmissionsDiffPercent` is positive if this flight emits more than typical, negative if less - Multi-city searches (`type: 3`) are not supported by the upstream API - Prices fluctuate — run repeatedly to track fare changes over time - Use comma-separated IATA codes in `departureId`/`arrivalId` for multi-airport searches (e.g., `"JFK,LGA,EWR"`) # Actor input Schema ## `departureId` (type: `string`): Origin airport IATA code. Supports multiple airports separated by commas (e.g., 'JFK,LGA,EWR' for New York area). ## `arrivalId` (type: `string`): Destination airport IATA code. Supports multiple airports separated by commas (e.g., 'LAX,BUR,LGB' for Los Angeles area). ## `outboundDate` (type: `string`): Departure date in YYYY-MM-DD format (e.g., '2026-09-15'). ## `returnDate` (type: `string`): Return date in YYYY-MM-DD format. Required when trip type is Round trip. ## `tripType` (type: `string`): One way or round trip. ## `adults` (type: `integer`): Number of adult passengers (1–9). ## `children` (type: `integer`): Number of child passengers (0–9). ## `travelClass` (type: `string`): Preferred cabin class. ## `stops` (type: `string`): Maximum number of stops. ## `sortBy` (type: `string`): Result sort order. ## `includeAirlines` (type: `string`): Show only these airlines. Comma-separated IATA codes (e.g., 'DL,AA,UA'). Cannot be used with Exclude airlines. ## `excludeAirlines` (type: `string`): Hide these airlines. Comma-separated IATA codes (e.g., 'F9,NK,SP'). Cannot be used with Include airlines. ## `currency` (type: `string`): Price currency code (e.g., 'USD', 'EUR', 'GBP', 'TRY'). ## `language` (type: `string`): Language code for results (e.g., 'en', 'de', 'tr'). ## `country` (type: `string`): Two-letter country code for geo-targeting (e.g., 'us', 'gb', 'de'). ## `maxItems` (type: `integer`): Maximum number of flight itineraries to return. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## Actor input object example ```json { "departureId": "JFK", "arrivalId": "LAX", "outboundDate": "2026-12-15", "tripType": "2", "adults": 1, "children": 0, "travelClass": "1", "stops": "0", "sortBy": "1", "currency": "USD", "language": "en", "country": "us", "maxItems": 20, "requestTimeoutSecs": 30 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "departureId": "JFK", "arrivalId": "LAX", "outboundDate": "2026-12-15", "currency": "USD", "language": "en", "country": "us" }; // Run the Actor and wait for it to finish const run = await client.actor("zerobreak/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "departureId": "JFK", "arrivalId": "LAX", "outboundDate": "2026-12-15", "currency": "USD", "language": "en", "country": "us", } # Run the Actor and wait for it to finish run = client.actor("zerobreak/google-flights-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "departureId": "JFK", "arrivalId": "LAX", "outboundDate": "2026-12-15", "currency": "USD", "language": "en", "country": "us" }' | apify call zerobreak/google-flights-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zerobreak/google-flights-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Flights Scraper", "description": "Google Flights scraper that collects itineraries, prices, airlines, durations, layovers, and carbon emissions for any route and date, so you can monitor fares, compare options, and build travel price trackers.", "version": "0.0", "x-build-id": "So1nifTIvC9aE3FKH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zerobreak~google-flights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zerobreak-google-flights-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zerobreak~google-flights-scraper/runs": { "post": { "operationId": "runs-sync-zerobreak-google-flights-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zerobreak~google-flights-scraper/run-sync": { "post": { "operationId": "run-sync-zerobreak-google-flights-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "departureId", "arrivalId", "outboundDate" ], "properties": { "departureId": { "title": "Departure airport (IATA)", "type": "string", "description": "Origin airport IATA code. Supports multiple airports separated by commas (e.g., 'JFK,LGA,EWR' for New York area)." }, "arrivalId": { "title": "Arrival airport (IATA)", "type": "string", "description": "Destination airport IATA code. Supports multiple airports separated by commas (e.g., 'LAX,BUR,LGB' for Los Angeles area)." }, "outboundDate": { "title": "Outbound date", "type": "string", "description": "Departure date in YYYY-MM-DD format (e.g., '2026-09-15')." }, "returnDate": { "title": "Return date", "type": "string", "description": "Return date in YYYY-MM-DD format. Required when trip type is Round trip." }, "tripType": { "title": "Trip type", "enum": [ "2", "1" ], "type": "string", "description": "One way or round trip.", "default": "2" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult passengers (1–9).", "default": 1 }, "children": { "title": "Children", "minimum": 0, "maximum": 9, "type": "integer", "description": "Number of child passengers (0–9).", "default": 0 }, "travelClass": { "title": "Cabin class", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Preferred cabin class.", "default": "1" }, "stops": { "title": "Stops", "enum": [ "0", "1", "2", "3" ], "type": "string", "description": "Maximum number of stops.", "default": "0" }, "sortBy": { "title": "Sort by", "enum": [ "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Result sort order.", "default": "1" }, "includeAirlines": { "title": "Include airlines", "type": "string", "description": "Show only these airlines. Comma-separated IATA codes (e.g., 'DL,AA,UA'). Cannot be used with Exclude airlines." }, "excludeAirlines": { "title": "Exclude airlines", "type": "string", "description": "Hide these airlines. Comma-separated IATA codes (e.g., 'F9,NK,SP'). Cannot be used with Include airlines." }, "currency": { "title": "Currency", "type": "string", "description": "Price currency code (e.g., 'USD', 'EUR', 'GBP', 'TRY').", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Language code for results (e.g., 'en', 'de', 'tr').", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code for geo-targeting (e.g., 'us', 'gb', 'de').", "default": "us" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of flight itineraries to return.", "default": 20 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```