{ "openapi": "3.0.1", "info": { "title": "Airport Delays Today: FAA Ground Stops & METAR/TAF", "description": "Get live US airport delays from the FAA (ground stops, ground delay programs, arrival and departure delays, closures) plus METAR and TAF weather for any airport. Monitor mode reports only new, updated and cleared events since the last run.", "version": "0.1", "x-build-id": "3JRTk94RsxNVaEZRT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data-done-right~airport-delays-weather/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data-done-right-airport-delays-weather", "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/data-done-right~airport-delays-weather/runs": { "post": { "operationId": "runs-sync-data-done-right-airport-delays-weather", "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/data-done-right~airport-delays-weather/run-sync": { "post": { "operationId": "run-sync-data-done-right-airport-delays-weather", "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": { "airports": { "title": "Airports", "type": "array", "description": "3-letter FAA/IATA codes (SFO, JFK, HNL) or 4-letter ICAO codes (KSFO, PHNL, EGLL). Leave empty to get every US airport with an active FAA event (weather needs airports). Non-US ICAO codes get weather only.", "items": { "type": "string" } }, "includeFaa": { "title": "FAA delays, ground stops and closures", "type": "boolean", "description": "Live US National Airspace System status from the FAA (nasstatus.faa.gov).", "default": true }, "eventTypes": { "title": "FAA event types", "type": "array", "description": "Which FAA events to return. Runway configuration and deicing are off by default (they are informational, not delays).", "items": { "type": "string", "enum": [ "ground_stop", "ground_delay", "arrival_delay", "departure_delay", "closure", "airspace_flow", "airport_config", "deicing" ], "enumTitles": [ "Ground stops", "Ground delay programs", "Arrival delays", "Departure delays", "Closures and NOTAM notices", "Airspace flow programs (only when no airports are listed)", "Runway configuration and arrival rate", "Deicing in progress" ] }, "default": [ "ground_stop", "ground_delay", "arrival_delay", "departure_delay", "closure", "airspace_flow" ] }, "includeMetar": { "title": "Current weather (METAR)", "type": "boolean", "description": "Latest observation per airport from aviationweather.gov: flight category (VFR/MVFR/IFR/LIFR), wind, visibility, ceiling, weather, raw METAR. One row per airport, which also carries a summary of its FAA status.", "default": true }, "includeTaf": { "title": "Forecast (TAF)", "type": "boolean", "description": "Adds the latest terminal forecast (raw TAF plus decoded periods) to each weather row. Only airports that issue TAFs have one.", "default": false }, "onlyChanges": { "title": "Only changes since my last run (monitor)", "type": "boolean", "description": "Returns only new, updated and cleared events (e.g. a ground stop was lifted), and weather rows only when the flight category, weather or TAF changed. Each row has change = new | updated | cleared. Schedule it every 5-15 minutes for alerts.", "default": false }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Optional. Runs with the same name share memory. By default the memory is tied to your airports and settings, so different tasks never mix." }, "maxRows": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Upper limit of rows per run. Also caps cost.", "default": 1000 } } }, "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 } } } } } } } } } }