# Google Flights API (`kaizu/google-flights-api`) Actor \[ALMOST FREE FOR LIMITED TIME] The fastest Google Flights API. Real-time prices with direct booking URLs, and price insights. one-way or round-trip, filter by stops/airlines/cabin class. Returns aircraft types, layover details, airport info. 40 currencies. - **URL**: https://apify.com/kaizu/google-flights-api.md - **Developed by:** [Tonny](https://apify.com/kaizu) (community) - **Categories:** Travel, SEO tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $0.00003 / run actor 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/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 - Real-Time Flight Prices & Calendar **The most reliable Google Flights API on Apify. Get real-time prices, schedules, and booking links for any route worldwide.** [![Price per run](https://img.shields.io/badge/price-%240.00003%2Frun-success)](https://apify.com/kaizu/google-flights-api) [![Response time](https://img.shields.io/badge/response-2--5%20seconds-blue)](https://apify.com/kaizu/google-flights-api) [![Currencies](https://img.shields.io/badge/currencies-40%2B-orange)](https://apify.com/kaizu/google-flights-api) --- ### Limited Time Offer **Promotional pricing is now live!** Run this Actor for just **$0.00003 per execution** — platform usage included for free. That's 500x cheaper than most competitors. This offer won't last long, so take advantage while it lasts. --- ### Why Choose This Scraper? **⚡ Blazing Fast** — Results in 2-5 seconds (5x faster than competitors) **🌍 Global Coverage** — 9,000+ airports worldwide, all major airlines **💰 Best Value** — Only $0.00003 per run (promotional pricing) **🔗 Direct Booking Links** — Get clickable Google Flights URLs to book instantly **🌱 Carbon Footprint** — Track CO2 emissions for eco-conscious travel **📊 Rich Data** — Layover details, aircraft types, price insights, airport info --- ### What You Get #### For Every Flight Search: - ✅ **Real-time prices** from Google Flights (not cached) - ✅ **Direct booking URLs** — Click to book on Google Flights - ✅ **Complete itineraries** — All legs, layovers, aircraft types - ✅ **Carbon emissions** — Environmental impact data - ✅ **Price insights** — "Typical", "Low", or "High" price indicator - ✅ **Airport details** — Full airport names, cities, countries - ✅ **37 currencies** — Local pricing for global markets #### Price Calendar Mode: Find the cheapest dates across any date range. Perfect for flexible travelers. --- ### Perfect For | Use Case | How It Helps | |----------|--------------| | **Travel Startups** | Power your flight comparison app with real Google data | | **Price Tracking** | Monitor routes and get alerts when prices drop | | **Travel Agencies** | Quote accurate prices to customers instantly | | **Data Science** | Analyze airline pricing patterns & trends | | **Trip Planning** | Find the cheapest dates to fly with calendar view | | **Affiliate Sites** | Monetize with direct booking links | --- ### Live Example **Input:** ```json { "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "2026-06-15", "adults": 1, "currency": "USD" } ```` **Output (Real Flight):** ```json { "airline": "JetBlue", "flightNumber": "B6 1523", "departureAirport": "JFK", "arrivalAirport": "LAX", "departureTime": "15:15", "arrivalTime": "18:17", "duration": "6 hr 2 min", "durationMinutes": 362, "price": 169, "priceFormatted": "$169", "booking_url": "https://www.google.com/travel/flights/booking?tfs=...", "carbonEmissions": { "totalKg": 145, "differencePercent": -12 }, "layovers": [], "legs": [ { "airline": "JetBlue", "flightNumber": "B6 1523", "departure": "JFK", "arrival": "LAX", "departureTime": "15:15", "arrivalTime": "18:17", "duration": "6 hr 2 min", "durationMinutes": 362, "aircraft": "Airbus A320" } ] } ``` *** ### Output Fields Reference | Field | Description | Example | |-------|-------------|---------| | `airline` | Airline name | "JetBlue" | | `flightNumber` | Full flight number | "B6 1523" | | `price` | Price in selected currency | 169 | | `priceFormatted` | Human-readable price | "$169" | | `booking_url` | Direct booking link | "https://www.google.com/travel/flights/booking?..." | | `durationMinutes` | Total flight time | 362 | | `stops` | Number of stops | 0 | | `layovers` | Stop details with duration | \[{"airport": "AUH", "duration": "2 hr 20 min"}] | | `carbonEmissions` | CO2 data | {"totalKg": 145, "differencePercent": -12} | | `legs` | Individual flight segments | See above | | `isBest` | Google "best" flag | true | **Bonus:** OUTPUT key-value includes `airports`, `priceInsights`, and `flightsUrl` *** ### How to Use #### 1. Quick Start (30 seconds) 1. Click **Try for free** 2. Enter airport codes (e.g., JFK → LAX) 3. Set your travel date 4. Click **Start** 5. Download JSON/CSV/Excel #### 2. Advanced Filters - **Max stops:** 0 (nonstop) to 3 - **Max price:** Set your budget limit - **Airlines:** Filter by specific carriers (AA, DL, UA) - **Cabin class:** Economy to First - **Currency:** 40+ currencies supported #### 3. One-Way vs Round-Trip **One-way flight:** Leave `return_date` empty ```json { "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "2026-06-15", "return_date": null } ``` **Round-trip flight:** Add `return_date` ```json { "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "2026-06-15", "return_date": "2026-06-22" } ``` #### 4. Price Calendar Set `type: "calendar"` to find cheapest dates across a range. *** ### Pricing This Actor's pricing details are outlined in the table below. Visit our [pricing page](https://apify.com/pricing) to compare plans and see how much you can save. | Pricing | Cost | |---------|------| | **Run actor** | | | One-time event | | | Just the run of the actor, no matter how many results. | **$0.00003** | | **Additional costs** | | | Platform usage | Included | | Platform usage costs are tied to the Actor's performance in terms of the underlying platform resources it consumes. [Learn more](https://docs.apify.com/platform/actors/running/compute-units) | **Free** | See all usage prices - we give it almost for free! *** ### Supported Currencies (40+) USD, EUR, GBP, JPY, CNY, KRW, INR, BRL, CAD, AUD, CHF, SEK, NOK, DKK, PLN, CZK, HUF, TRY, THB, MXN, SGD, HKD, NZD, ZAR, RUB, ILS, AED, SAR, PHP, MYR, IDR, TWD, ARS, CLP, COP, PEN, VND, EGP, NGN, KES *** ### Integrations **Export to:** - 📊 Google Sheets - 📧 Email notifications - 💬 Slack alerts - 🔄 Webhooks - ☁️ Amazon S3 - 🗄️ Any REST API **Scheduling:** - Run hourly, daily, or custom intervals - Get alerts when prices drop - Monitor competitor routes *** ### Data Reliability ✅ **Real-time data** — Direct from Google Flights (not cached)\ ✅ **99%+ uptime** — Enterprise-grade infrastructure\ ✅ **Automatic retries** — Handles transient failures\ ✅ **Input validation** — Clear error messages\ ✅ **Structured output** — Clean JSON, no HTML parsing *** ### Limits - Max 9 adult passengers per search - Valid IATA airport codes only (3 letters) - Future dates only (YYYY-MM-DD format) - 30-second timeout per request *** ### For Actor Owners (Setting Up This Actor) **To configure pricing:** 1. Push to Apify: `npx apify push` 2. Go to [Apify Console](https://console.apify.com) → Your Actor 3. Click **"Monetization"** in left sidebar 4. Set **Pay-per-event** pricing: - Price: $0.015 per run - Event name: "Actor run" 5. Click **Save** **To set environment variables:** 1. Actor Settings → Environment variables 2. Add secrets: - `API_URL` = `https://flights-api.wonderbook.co.il` - `API_KEY` = your production API key 3. Mark both as **Secret** (encrypted) See `DEPLOYMENT.md` for full deployment guide. *** ### Need Help? - 📖 **Documentation:** Check the OUTPUT tab for each run - 💬 **Support:** Message via Apify platform - 🐛 **Issues:** Include your input JSON and error message *** **Start extracting flight data today. Click "Try for free" →** # Actor input Schema ## `type` (type: `string`): Choose between flight search or price calendar. ## `departure_id` (type: `string`): IATA airport code (e.g. JFK, LAX, CDG). For multiple airports, comma-separate: CDG,ORY ## `arrival_id` (type: `string`): IATA airport code (e.g. LAX, LHR, NRT). For multiple airports, comma-separate: LHR,LGW ## `outbound_date` (type: `string`): Departure date in YYYY-MM-DD format. ## `return_date` (type: `string`): Return date for round-trip flights (YYYY-MM-DD). Leave empty for one-way. ## `adults` (type: `integer`): Number of adult passengers (1-9). ## `children` (type: `integer`): Number of child passengers. ## `infants` (type: `integer`): Number of infant passengers (lap). ## `currency` (type: `string`): ISO 4217 currency code for prices. ## `seat` (type: `string`): Seat/cabin class. ## `max_stops` (type: `integer`): Filter by maximum number of stops. 0 = nonstop only. Leave empty for any. ## `max_price` (type: `integer`): Filter flights above this price. Leave empty for no limit. ## `airlines` (type: `string`): Comma-separated IATA airline codes (e.g. AA,DL,UA). Leave empty for all airlines. ## `hl` (type: `string`): Language code for results. ## `gl` (type: `string`): Country code (affects pricing region). ## Actor input object example ```json { "type": "search", "departure_id": "JFK", "arrival_id": "LAX", "adults": 1, "children": 0, "infants": 0, "currency": "USD", "seat": "economy", "hl": "en", "gl": "us" } ``` # Actor output Schema ## `flights` (type: `string`): Flight search results with prices, schedules, aircraft types, and booking links ## `searchSummary` (type: `string`): Summary of search results including price insights, airports, and flights URL # 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 = { "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "" }; // Run the Actor and wait for it to finish const run = await client.actor("kaizu/google-flights-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "", } # Run the Actor and wait for it to finish run = client.actor("kaizu/google-flights-api").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 '{ "departure_id": "JFK", "arrival_id": "LAX", "outbound_date": "" }' | apify call kaizu/google-flights-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kaizu/google-flights-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Flights API", "description": "[ALMOST FREE FOR LIMITED TIME] The fastest Google Flights API. Real-time prices with direct booking URLs, and price insights. one-way or round-trip, filter by stops/airlines/cabin class. Returns aircraft types, layover details, airport info. 40 currencies.", "version": "1.0", "x-build-id": "wJ4cDRp1GTE7WdDJz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaizu~google-flights-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaizu-google-flights-api", "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/kaizu~google-flights-api/runs": { "post": { "operationId": "runs-sync-kaizu-google-flights-api", "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/kaizu~google-flights-api/run-sync": { "post": { "operationId": "run-sync-kaizu-google-flights-api", "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": [ "departure_id", "arrival_id", "outbound_date" ], "properties": { "type": { "title": "Search Type", "enum": [ "search", "calendar" ], "type": "string", "description": "Choose between flight search or price calendar.", "default": "search" }, "departure_id": { "title": "Departure Airport", "type": "string", "description": "IATA airport code (e.g. JFK, LAX, CDG). For multiple airports, comma-separate: CDG,ORY" }, "arrival_id": { "title": "Arrival Airport", "type": "string", "description": "IATA airport code (e.g. LAX, LHR, NRT). For multiple airports, comma-separate: LHR,LGW" }, "outbound_date": { "title": "Outbound Date", "type": "string", "description": "Departure date in YYYY-MM-DD format." }, "return_date": { "title": "Return Date", "type": "string", "description": "Return date for round-trip flights (YYYY-MM-DD). Leave empty for one-way." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult passengers (1-9).", "default": 1 }, "children": { "title": "Children", "minimum": 0, "maximum": 8, "type": "integer", "description": "Number of child passengers.", "default": 0 }, "infants": { "title": "Infants", "minimum": 0, "maximum": 4, "type": "integer", "description": "Number of infant passengers (lap).", "default": 0 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "CNY", "KRW", "INR", "BRL", "CAD", "AUD", "CHF", "SEK", "NOK", "DKK", "PLN", "CZK", "HUF", "TRY", "THB", "MXN", "SGD", "HKD", "NZD", "ZAR", "RUB", "ILS", "AED", "SAR", "PHP", "MYR", "IDR", "TWD", "ARS", "CLP", "COP", "PEN", "VND", "EGP", "NGN", "KES" ], "type": "string", "description": "ISO 4217 currency code for prices.", "default": "USD" }, "seat": { "title": "Cabin Class", "enum": [ "economy", "premium-economy", "business", "first" ], "type": "string", "description": "Seat/cabin class.", "default": "economy" }, "max_stops": { "title": "Maximum Stops", "minimum": 0, "maximum": 3, "type": "integer", "description": "Filter by maximum number of stops. 0 = nonstop only. Leave empty for any." }, "max_price": { "title": "Maximum Price", "minimum": 1, "type": "integer", "description": "Filter flights above this price. Leave empty for no limit." }, "airlines": { "title": "Airlines Filter", "type": "string", "description": "Comma-separated IATA airline codes (e.g. AA,DL,UA). Leave empty for all airlines." }, "hl": { "title": "Language", "type": "string", "description": "Language code for results.", "default": "en" }, "gl": { "title": "Country", "type": "string", "description": "Country code (affects pricing region).", "default": "us" } } }, "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 } } } } } } } } } } ```