{ "openapi": "3.0.1", "info": { "title": "Google Flights Scraper & API: Prices, One-Way & Round-Trip", "description": "Flight offers from Google Flights for your trips: one-way or round trip, dates, passengers, cabin, stops and airlines. Each offer with its price and currency, airlines, flight numbers, stops, layovers, times, durations, aircraft and CO2. Several trips per run.", "version": "0.1", "x-build-id": "lW7ldtCaXfqp21Omn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quarra~google-flights-price-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quarra-google-flights-price-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/quarra~google-flights-price-scraper/runs": { "post": { "operationId": "runs-sync-quarra-google-flights-price-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/quarra~google-flights-price-scraper/run-sync": { "post": { "operationId": "run-sync-quarra-google-flights-price-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": [ "trips" ], "properties": { "trips": { "title": "Trips", "type": "array", "description": "Airport or city codes (IATA), then optional dates: 'LAX-JFK' (uses the dates below), 'LAX-JFK 2026-12-10' (one way), 'LAX-JFK 2026-12-10 2026-12-17' (round trip). Relative dates work too, with their unit: 'LAX-JFK 30 days 37 days'. Write dates as YYYY-MM-DD (12/20 is refused, not guessed). Up to 2,000 trips per run.", "items": { "type": "string" } }, "departureDate": { "title": "Departure date", "type": "string", "description": "For trips without their own date. A date (2026-12-10) or a relative one ('30 days'). Google Flights shows flights up to 329 days ahead (about 11 months).", "default": "30 days" }, "returnDate": { "title": "Return date (round trip)", "type": "string", "description": "Set it for round trips: trips without their own dates come back on this date. Leave empty for one-way trips." }, "returnFlightsFor": { "title": "Return flights for the cheapest outbound flights", "minimum": 0, "maximum": 10, "type": "integer", "description": "Round trips: Google Flights lists outbound flights first, each with its round-trip price. Set how many of the cheapest outbound flights also get their return flights listed (each return option with the round-trip total). 0 = outbound flights only.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Prices are the total for all passengers.", "default": 1 }, "children": { "title": "Children (2-11)", "minimum": 0, "maximum": 8, "type": "integer", "description": "Children aged 2 to 11. 9 passengers in all at most. Infants (under 2) are not supported.", "default": 0 }, "cabinClass": { "title": "Cabin", "enum": [ "economy", "premiumEconomy", "business", "first" ], "type": "string", "description": "Cabin searched.", "default": "economy" }, "maxStops": { "title": "Stops", "enum": [ "any", "nonstop", "oneStop", "twoStops" ], "type": "string", "description": "Most stops per direction.", "default": "any" }, "includeAirlines": { "title": "Only these airlines", "type": "array", "description": "2-letter airline codes (AA, DL, B6) or an alliance (STAR_ALLIANCE, SKYTEAM, ONEWORLD).", "items": { "type": "string" } }, "excludeAirlines": { "title": "Not these airlines", "type": "array", "description": "2-letter airline codes or an alliance.", "items": { "type": "string" } }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "3-letter code (USD, EUR, GBP…). Each price comes with the currency Google Flights actually used.", "default": "USD" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Total number of charged flights the run delivers, counted exactly. Free records (errors, flights without a price, trips with no flight) are not counted.", "default": 100 }, "proxyConfiguration": { "title": "Connection", "type": "object", "description": "Connection. Keep the default (automatic): other settings are not needed and are not used. Costs are included in the price.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }