{ "openapi": "3.0.1", "info": { "title": "Google Flights Scraper & API - Airfare Price Tracker, No Login", "description": "Get every flight Google Flights shows for any route and date: fares, airlines, flight numbers, times, layovers, aircraft and CO2, plus Google's typical price range and 60-day price history. Round trips with return options. Track fare changes on a schedule. No login, no API key.", "version": "0.1", "x-build-id": "cdegjbfjVGmQfWbP4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/headply~google-flights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-headply-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/headply~google-flights-scraper/runs": { "post": { "operationId": "runs-sync-headply-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/headply~google-flights-scraper/run-sync": { "post": { "operationId": "run-sync-headply-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", "properties": { "routes": { "title": "Routes", "type": "array", "description": "One route per line as two 3-letter airport or city codes: \"JFK-LAX\", \"LHR-LIS\", or city codes like \"NYC-LON\" (all airports of both cities).", "default": [], "items": { "type": "string" } }, "departureDate": { "title": "Departure date", "type": "string", "description": "YYYY-MM-DD, or a number of days from the run date (\"30\" = 30 days ahead, so scheduled runs keep the same lead time). Default: 30 days ahead.", "default": "" }, "returnDate": { "title": "Return date (round trip)", "type": "string", "description": "YYYY-MM-DD or days from the run date. Leave empty (and \"Trip length\" empty) for one-way.", "default": "" }, "tripLength": { "title": "Trip length in days (round trip)", "minimum": 1, "maximum": 330, "type": "integer", "description": "Alternative to a return date: return this many days after departure. Leave empty for one-way." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Adult passengers. Prices are totals for all passengers.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "maximum": 8, "type": "integer", "description": "Children aged 2–11.", "default": 0 }, "infants": { "title": "Infants (on lap)", "minimum": 0, "maximum": 4, "type": "integer", "description": "Infants under 2 travelling on a lap.", "default": 0 }, "cabinClass": { "title": "Cabin class", "enum": [ "economy", "premium-economy", "business", "first" ], "type": "string", "description": "Cabin to price.", "default": "economy" }, "maxStops": { "title": "Stops", "enum": [ "any", "0", "1", "2" ], "type": "string", "description": "Limit the number of stops.", "default": "any" }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all fares (USD, EUR, GBP, INR, JPY…).", "default": "USD" }, "returnFlightsFor": { "title": "Return options for the N cheapest outbound flights", "minimum": 0, "maximum": 10, "type": "integer", "description": "Round trips only. For each of the N cheapest outbound flights, also return the matching return flights with the round-trip total (one extra page each). 0 returns outbound options only.", "default": 1 }, "maxFlightsPerSearch": { "title": "Max flights per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on itineraries per route (Google shows 20–60 for most routes).", "default": 100 }, "mode": { "title": "Mode", "enum": [ "all", "priceChanges" ], "type": "string", "description": "\"All flights\" returns everything found. \"Only fare changes\" remembers each itinerary's price per search and, after the first (baseline) run, returns and bills only itineraries whose price changed since the previous run with the same monitor name. Use it with a schedule for fare alerts.", "default": "all" }, "includeNewFlights": { "title": "Also report new flights", "type": "boolean", "description": "Only in \"fare changes\" mode: also return itineraries that were not in the previous run's results.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Only in \"fare changes\" mode. Separate schedules with different names keep separate memories.", "default": "default" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many searches to load at once.", "default": 6 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy with US exits works well. The exit country sets the market Google prices for.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } }, "selfTest": { "title": "Self-test (maintainers)", "type": "boolean", "description": "Fail the run if the output looks broken. Used by the daily health check.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }