{ "openapi": "3.0.1", "info": { "title": "NOAA Weather Forecast & Alerts (Official API)", "description": "US weather forecasts and active severe weather alerts from the official National Weather Service API. Daily or hourly forecasts for any US coordinates, and alerts filtered by state, severity, urgency or event type. No API key needed. Public domain U.S. government data.", "version": "0.1", "x-build-id": "O2cTq1n8pB9L7WOHV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kdhan~noaa-weather-forecast-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kdhan-noaa-weather-forecast-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/kdhan~noaa-weather-forecast-alerts/runs": { "post": { "operationId": "runs-sync-kdhan-noaa-weather-forecast-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/kdhan~noaa-weather-forecast-alerts/run-sync": { "post": { "operationId": "run-sync-kdhan-noaa-weather-forecast-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": { "user_agent": { "title": "Your contact (required by NWS)", "type": "string", "description": "The National Weather Service asks every automated client to identify itself. Replace this with your own name and email, for example: Jane Doe jane@example.com", "default": "kdhan Apify Actor kdhan2001@gmail.com" }, "mode": { "title": "What to fetch", "enum": [ "forecast", "alerts" ], "type": "string", "description": "Forecast for specific coordinates, or currently active weather alerts.", "default": "forecast" }, "coordinates": { "title": "Coordinates (forecast mode)", "type": "array", "description": "One or more US points as 'latitude,longitude'. Example: 38.8894,-77.0352", "default": [ "38.8894,-77.0352" ], "items": { "type": "string" } }, "hourly": { "title": "Hourly instead of daily", "type": "boolean", "description": "Daily forecast gives about 14 periods. Hourly gives about 156.", "default": false }, "periods_per_point": { "title": "Periods per location", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap how many forecast periods to keep for each coordinate. Leave empty for all." }, "area": { "title": "State (alerts mode)", "type": "string", "description": "Two-letter state or marine area code, for example TX, CA, FL. Leave empty for the whole country." }, "severity": { "title": "Severity (alerts mode)", "enum": [ "Extreme", "Severe", "Moderate", "Minor", "Unknown" ], "type": "string", "description": "Keep only alerts at this severity." }, "urgency": { "title": "Urgency (alerts mode)", "enum": [ "Immediate", "Expected", "Future", "Past", "Unknown" ], "type": "string", "description": "Keep only alerts at this urgency." }, "event": { "title": "Event type (alerts mode)", "type": "string", "description": "Exact event name, for example Flood Warning, Tornado Watch, Winter Storm Warning." }, "max_results": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "You are charged per returned row.", "default": 100 } } }, "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 } } } } } } } } } }