{ "openapi": "3.0.1", "info": { "title": "NWS Weather API: Forecast, Observations and Alerts", "description": "Get the US National Weather Service forecast, latest valid station observation and active alerts for each coordinate or station ID, plus active alerts by state. One flat row per location. Public NWS data, $4.00 per 1,000 rows.", "version": "1.0", "x-build-id": "yA802XBaYjIUywVgP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/conserving_celerytop~nws-weather-forecast-alerts-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-conserving_celerytop-nws-weather-forecast-alerts-api", "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/conserving_celerytop~nws-weather-forecast-alerts-api/runs": { "post": { "operationId": "runs-sync-conserving_celerytop-nws-weather-forecast-alerts-api", "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/conserving_celerytop~nws-weather-forecast-alerts-api/run-sync": { "post": { "operationId": "run-sync-conserving_celerytop-nws-weather-forecast-alerts-api", "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": { "coordinates": { "title": "Coordinates", "type": "array", "description": "Add latitude and longitude pairs, one per line, for example 47.6062,-122.3321. Use points in the United States, its territories or nearby waters.", "items": { "type": "string" } }, "stationIds": { "title": "Station IDs", "type": "array", "description": "Add NWS observation station IDs, one per line, for example KSEA or KDEN. Each ID returns the latest observation of that station with the forecast and alerts for its location.", "items": { "type": "string" } }, "alertStates": { "title": "State codes", "type": "array", "description": "Add two-letter state, territory or marine area codes, one per line, for example WA, TX or PR. Each code returns one row with every active alert for that area.", "items": { "type": "string" } }, "forecastPeriods": { "title": "Forecast periods", "minimum": 1, "maximum": 14, "type": "integer", "description": "Set how many forecast periods to list for each location, from 1 to 14. A period is a day or a night, so 14 periods cover 7 days.", "default": 6 }, "units": { "title": "Units", "enum": [ "us", "si" ], "type": "string", "description": "Choose the units for forecast temperatures and wind. Observation rows carry both Celsius and Fahrenheit.", "default": "us" }, "includeForecast": { "title": "Forecast", "type": "boolean", "description": "Turn on to add the forecast periods to each location row.", "default": true }, "includeObservation": { "title": "Latest observation", "type": "boolean", "description": "Turn on to add the latest valid observation from the nearest reporting station.", "default": true }, "includeAlerts": { "title": "Active alerts", "type": "boolean", "description": "Turn on to add the active alerts for each location.", "default": true }, "alertSeverities": { "title": "Alert severities", "type": "array", "description": "Pick the severities to list. The default lists every severity.", "items": { "type": "string", "enum": [ "Extreme", "Severe", "Moderate", "Minor", "Unknown" ] } }, "includeAlertText": { "title": "Alert text", "type": "boolean", "description": "Turn on to add the description and the instruction of each alert.", "default": true }, "maxAlertsPerRow": { "title": "Maximum alerts per row", "minimum": 1, "maximum": 200, "type": "integer", "description": "Set how many alerts to list in one row, from 1 to 200. The most severe alerts come first and the alert count shows the full total.", "default": 50 }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "Return only items that this monitor has not delivered before. The first run returns everything and becomes the baseline. Use it with a daily schedule.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Names the memory of this monitor. Use one name per saved task, so two tasks never share their memory.", "default": "default" } } }, "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 } } } } } } } } } }