{ "openapi": "3.0.1", "info": { "title": "US Weather Alerts API - Active NWS Severe Storm Warnings", "description": "For alerting bots, insurance response, logistics and event planning: active severe weather alerts, warnings and watches from the US National Weather Service with event, severity, urgency, certainty, the counties covered and the NWS text unedited. The whole US had 185 active alerts on 2026-09-12.", "version": "0.1", "x-build-id": "UdmdoC5UgrYuqKde6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~us-weather-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-us-weather-alerts", "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/neverempty~us-weather-alerts/runs": { "post": { "operationId": "runs-sync-neverempty-us-weather-alerts", "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/neverempty~us-weather-alerts/run-sync": { "post": { "operationId": "run-sync-neverempty-us-weather-alerts", "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": { "areas": { "title": "Areas", "type": "array", "description": "What to check. Use US for the whole country, a two-letter state or territory code (CA, TX, PR), or a point as \"lat,lon\" (38.89,-77.03). Mix them freely. Leave this out entirely and the whole US is used as an example, with a free row and a log line saying so; the whole country has roughly 185 active alerts at any moment, and a run returns at most Maximum alerts (50 by default), so raise that if you want all of them. Giving an empty list is treated as a mistake, not as \"everywhere\": nothing is fetched and a free row explains why.", "items": { "type": "string" } }, "severity": { "title": "Severity filter", "type": "array", "description": "Keep only these severities. Leave empty for all. NWS values: Extreme, Severe, Moderate, Minor, Unknown.", "default": [], "items": { "type": "string" } }, "urgency": { "title": "Urgency filter", "type": "array", "description": "Keep only these urgencies. Leave empty for all. NWS values: Immediate, Expected, Future, Past, Unknown.", "default": [], "items": { "type": "string" } }, "event": { "title": "Event type filter", "type": "array", "description": "Keep only these event names, exactly as NWS writes them, e.g. \"Tornado Warning\", \"Heat Advisory\", \"Flood Watch\". Leave empty for all.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Maximum alerts", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The largest number of alert rows this run returns and charges for, counted across every area you gave. The default is 50, which keeps a run to about $0.40 whatever the weather is doing. The whole US carries roughly 185 active alerts at any moment, so raise this to 185 or more (up to 100000) if you want the entire country in one run. When the limit is reached, a free row tells you how many alerts were left behind and which areas were not checked, so a truncated result is never mistaken for a complete one. Rows that report zero alerts, a bad input or an NWS outage are never charged and do not count towards this.", "default": 50 }, "maxRetries": { "title": "Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry an area when NWS rate-limits or has an outage, before writing a row that says why.", "default": 3 } } }, "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 } } } } } } } } } }