{ "openapi": "3.0.1", "info": { "title": "OpenSky Live Flight Tracking Scraper", "description": "Live ADS-B aircraft positions worldwide plus airport arrival and departure history, from the OpenSky Network. Turns OpenSky's bare positional arrays into named fields, strips padded callsigns and keeps barometric and GNSS altitude apart.", "version": "0.1", "x-build-id": "KvmpNQXVlzNUhLpif" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~opensky-flights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-opensky-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/scrapyx~opensky-flights-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-opensky-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/scrapyx~opensky-flights-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-opensky-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": { "mode": { "title": "Mode", "enum": [ "liveStates", "flights" ], "type": "string", "description": "'liveStates' is a snapshot of every aircraft airborne right now. 'flights' is arrival/departure history for an airport — anonymous access reaches back about a day.", "default": "liveStates" }, "boundingBoxes": { "title": "Bounding boxes", "type": "array", "description": "liveStates only. Each box is 'lamin,lomin,lamax,lomax', e.g. '51,3,53,6' for the Netherlands. Leave empty for the whole world (~8,600 aircraft). Each box runs separately and gets its own summary row.", "items": { "type": "string" } }, "icao24Codes": { "title": "Aircraft transponder codes (ICAO 24-bit)", "type": "array", "description": "liveStates only. Restrict to specific aircraft by hex transponder address, e.g. 4bb143.", "items": { "type": "string" } }, "airports": { "title": "Airports (ICAO codes)", "type": "array", "description": "flights mode only. Four-letter ICAO codes, e.g. EHAM, KJFK, EGLL. Validated locally — OpenSky answers an unknown code with the SAME '404 []' it uses for a real airport with no flights, so a typo would otherwise look like 'nothing flew'.", "items": { "type": "string" } }, "direction": { "title": "Arrivals, departures or both", "enum": [ "both", "arrival", "departure" ], "type": "string", "description": "flights mode only.", "default": "both" }, "hoursBack": { "title": "Hours of history", "minimum": 1, "maximum": 24, "type": "integer", "description": "flights mode only. Anonymous OpenSky access reaches back about a day — measured, a window 2 days back answers 403. Capped at 24 here.", "default": 6 }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 0, "type": "integer", "description": "0 = unlimited. A whole-world liveStates snapshot is around 8,600 aircraft.", "default": 500 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Requests in flight at once. OpenSky's credit budget is per-IP, so a high value spends it faster rather than going faster.", "default": 2 }, "minRequestInterval": { "title": "Min seconds between request starts", "minimum": 0, "maximum": 60, "type": "number", "description": "Politeness pacing. Anonymous users get 400 credits a day; a bounding box costs 1–4 depending on its area.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Recommended for cloud runs. No WAF was observed, but OpenSky's anonymous budget is 400 credits per DAY per IP — and on a shared cloud IP that budget is often already spent by other users, so a run can fail with rate_limited through no fault of the query. Each proxy exit IP has its own budget.", "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 } } }, "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 } } } } } } } } } }