{ "openapi": "3.0.1", "info": { "title": "Google Flights Scraper & Price Monitor - Airfare API", "description": "Scrape live Google Flights prices, airlines, schedules, stops, connection airports, aircraft and CO2. Search multiple routes or dates, rank cheap fares, and create price alerts. No API key or login.", "version": "1.0", "x-build-id": "HqUmDNolhVFnEfhZe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~google-flights-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-google-flights-price-monitor", "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/groupoject~google-flights-price-monitor/runs": { "post": { "operationId": "runs-sync-groupoject-google-flights-price-monitor", "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/groupoject~google-flights-price-monitor/run-sync": { "post": { "operationId": "run-sync-groupoject-google-flights-price-monitor", "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": [ "origin", "destination", "departureDate" ], "properties": { "origin": { "title": "Origin airport", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Three-letter IATA airport code, for example JFK, LHR, CDG, DXB, or CMN.", "default": "JFK" }, "destination": { "title": "Destination airport", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Three-letter IATA airport code.", "default": "LAX" }, "departureDate": { "title": "Departure date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Travel date in YYYY-MM-DD format.", "default": "2026-10-15" }, "returnDate": { "title": "Return date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Adding a return date creates a round-trip search." }, "departureDateEnd": { "title": "Scan departure dates through", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional end date. The Actor searches every departure date in the range, up to 31 days." }, "additionalRoutes": { "title": "Additional routes", "type": "array", "description": "Bulk-search up to 50 more routes in the same run.", "items": { "type": "object", "properties": { "origin": { "title": "Origin", "type": "string", "description": "Three-letter origin IATA code." }, "destination": { "title": "Destination", "type": "string", "description": "Three-letter destination IATA code." }, "departureDate": { "title": "Departure date", "type": "string", "description": "Departure date in YYYY-MM-DD format." }, "returnDate": { "title": "Return date", "type": "string", "description": "Optional return date in YYYY-MM-DD format." } }, "required": [ "origin", "destination", "departureDate" ] }, "default": [] }, "cabinClass": { "title": "Cabin class", "enum": [ "economy", "premium-economy", "business", "first" ], "type": "string", "description": "Fare cabin to search.", "default": "economy" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult travelers.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "maximum": 8, "type": "integer", "description": "Number of child travelers.", "default": 0 }, "infantsInSeat": { "title": "Infants in seat", "minimum": 0, "maximum": 4, "type": "integer", "description": "Number of infants traveling in their own seats.", "default": 0 }, "infantsOnLap": { "title": "Infants on lap", "minimum": 0, "maximum": 4, "type": "integer", "description": "Number of lap infants.", "default": 0 }, "directOnly": { "title": "Direct flights only", "type": "boolean", "description": "Return only nonstop itineraries.", "default": false }, "maxStops": { "title": "Maximum stops", "minimum": 0, "maximum": 3, "type": "integer", "description": "Maximum number of connections accepted." }, "airlines": { "title": "Airline codes", "type": "array", "description": "Optional IATA airline codes such as AA, DL, BA, or AT.", "default": [], "items": { "type": "string" } }, "maxPrice": { "title": "Maximum price", "minimum": 0.01, "type": "number", "description": "Exclude itineraries above this total fare in the selected currency." }, "targetPrice": { "title": "Target price alert", "minimum": 0.01, "type": "number", "description": "Marks results at or below your target with belowTargetPrice=true." }, "maxResultsPerSearch": { "title": "Maximum flights per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum itinerary records saved for each route and date.", "default": 100 }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Three-letter ISO currency code.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Google language code, for example en-US, fr, de, or ar.", "default": "en-US" }, "includeRouteSummary": { "title": "Include route summary", "type": "boolean", "description": "Adds one summary row per search with lowest, median and direct-flight prices.", "default": true }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum route searches running at the same time.", "default": 2 }, "requestDelayMs": { "title": "Delay between searches (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum delay between starting route searches.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Enable an Apify residential proxy if Google limits a recurring or high-volume search." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Write transport diagnostics to the run log.", "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 } } }, "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 } } } } } } } } } }