{ "openapi": "3.0.1", "info": { "title": "FlightStats Flight Status Scraper - Delays, Gates, Tails", "description": "Track live flight status on FlightStats by flight number or route: delay minutes, gate, terminal, aircraft and tail number. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "zTwhVMYOdjJUfq6i9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~flightstats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-flightstats-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/parseforge~flightstats-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-flightstats-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/parseforge~flightstats-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-flightstats-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": { "startUrls": { "title": "FlightStats URLs", "type": "array", "description": "FlightStats flight tracker pages to read. A flight page looks like https://www.flightstats.com/v2/flight-tracker/BA/112 and a route board like https://www.flightstats.com/v2/flight-tracker/route/JFK/LHR. A year, month and date already in the URL wins over the Flight date field below. Leave empty and use Flight numbers or routes instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Flight numbers or routes", "type": "array", "description": "One entry per flight or per route. A flight designator such as BA112, AA 100 or B6 615 returns that single flight. An airport pair such as JFK-LHR or LAX to SFO returns the whole departure board for that route on the chosen date. Airport codes are three letter IATA codes.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. Leave empty on a paid plan for 100 rows." }, "flightDate": { "title": "Flight date", "type": "string", "description": "Departure date at the origin airport, as YYYY-MM-DD. Leave empty for today. Measured 2026-09-08: day minus 4 answers isOutOfDateRange and day plus 3 returns an empty board, so useful values run from three days ago to two days ahead." }, "codeshareHandling": { "title": "Codeshares on a route board", "enum": [ "operating", "all" ], "type": "string", "description": "A route board lists every ticketed flight number, so one aircraft can appear five or six times under different airlines. Operating flights only keeps the carrier that actually flies the aircraft. Measured 2026-09-08 on JFK to LHR: 120 ticketed rows, 23 operating flights. Ignored when the source is a single flight number.", "default": "operating" }, "flightStatuses": { "title": "Keep only these statuses", "uniqueItems": true, "type": "array", "description": "Leave empty to keep every flight. Scheduled, Departed and Arrived are the three states FlightStats publishes for a normal flight; Cancelled and Diverted come from the cancellation and diversion flags on the same record.", "items": { "type": "string", "enum": [ "Scheduled", "Departed", "Arrived", "Cancelled", "Diverted" ], "enumTitles": [ "Scheduled (not yet departed)", "Departed (in the air)", "Arrived (landed)", "Cancelled", "Diverted" ] } }, "minDelayMinutes": { "title": "Minimum delay in minutes", "minimum": 1, "maximum": 1440, "type": "integer", "description": "Keep only flights delayed by at least this many minutes at departure or at arrival. Leave empty to keep on-time flights too. Set 15 for the usual industry definition of a delayed flight." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "On by default. Measured 2026-09-08: 182 requests from one exit address in 62 seconds earned a bare HTTP 403, so the Actor rotates its exit IP every 100 requests and again on any 403. Turn it off only for very small runs.", "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 } } } } } } } } } }