{
"openapi": "3.0.1",
"info": {
"title": "Google Flights Scraper – All Flights, Prices & Price Insights",
"description": "Scrape all Google Flights results for any route and date: prices, airlines, flight numbers, times, stops, layovers, bags, emissions and booking links, plus price insights (low/typical/high, 60-day price history). Round trips, date ranges, filters. No proxy needed.",
"version": "1.0",
"x-build-id": "ZKkw0exiAXftucujH"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/brii3343~google-flights-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-brii3343-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/brii3343~google-flights-scraper/runs": {
"post": {
"operationId": "runs-sync-brii3343-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/brii3343~google-flights-scraper/run-sync": {
"post": {
"operationId": "run-sync-brii3343-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 airport or city codes: JFK-LAX, NYC-LON (all airports of a city), JFK,EWR-MIA (several airports). Each route is searched on every departure date.",
"items": {
"type": "string"
}
},
"departureDate": {
"title": "Departure date",
"type": "string",
"description": "YYYY-MM-DD, or a number of days from today (for example 30) so that scheduled runs never expire."
},
"departureDateTo": {
"title": "Last departure date (optional)",
"type": "string",
"description": "Search every day from the departure date to this date (up to 91 days), to find the cheapest days. Each day is a separate search. YYYY-MM-DD or days from today."
},
"returnDate": {
"title": "Return date (optional)",
"type": "string",
"description": "Leave empty for one-way flights. With a return date you get round trips: prices are the total for the round trip. With a date range, the length of stay stays the same for every day."
},
"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-11. Searches with infants are not supported yet.",
"default": 0
},
"cabinClass": {
"title": "Cabin class",
"enum": [
"economy",
"premium-economy",
"business",
"first"
],
"type": "string",
"description": "Travel class of the search.",
"default": "economy"
},
"maxStops": {
"title": "Stops",
"enum": [
"any",
"0",
"1",
"2"
],
"type": "string",
"description": "Maximum number of stops per direction.",
"default": "any"
},
"airlines": {
"title": "Airlines (optional)",
"type": "array",
"description": "Only these airlines, as 2-character IATA codes (DL, BA) or an alliance: STAR_ALLIANCE, SKYTEAM, ONEWORLD.",
"items": {
"type": "string"
}
},
"maxFlightsPerSearch": {
"title": "Max flights per search",
"minimum": 0,
"type": "integer",
"description": "Google Flights usually has 50-150 flights per route and day; 0 = all of them. They are saved in Google's order (top flights first).",
"default": 100
},
"returnFlightsForTop": {
"title": "Return flights for the first N outbound flights",
"minimum": 0,
"maximum": 20,
"type": "integer",
"description": "Round trips only. Google shows round trips as outbound flights with the total price; with N > 0 you also get the return options (and their total prices) for the first N outbound flights. Each outbound flight is one more search.",
"default": 0
},
"currency": {
"title": "Currency",
"type": "string",
"description": "3-letter code: USD, EUR, GBP, INR…",
"default": "USD"
},
"language": {
"title": "Language",
"type": "string",
"description": "Language of airport and airline names (en, de, fr, es, it…).",
"default": "en"
},
"country": {
"title": "Country",
"type": "string",
"description": "2-letter country code of the Google Flights site (us, gb, de, in…). Prices can differ by country.",
"default": "us"
},
"googleFlightsUrls": {
"title": "Google Flights links (optional)",
"type": "array",
"description": "Search links copied from google.com/travel/flights (they contain tfs=), with all your filters. You get all the flights of that search, not only the first ones.",
"items": {
"type": "string"
}
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Not needed: the scraper connects directly and switches to Apify Proxy by itself if Google slows it down."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}