{ "openapi": "3.0.1", "info": { "title": "Weather Forecast & Alerts Export (NWS + MET Norway)", "description": "Hourly or daily weather forecasts for up to 10 coordinates from the US National Weather Service and MET Norway, plus active NWS weather alerts for US points. UTC and local times, units, provider and update time on every row.", "version": "0.1", "x-build-id": "hbUaVPLwqzlsUNQVV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~weather-forecast-alerts-export/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-weather-forecast-alerts-export", "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/cliqtomedia~weather-forecast-alerts-export/runs": { "post": { "operationId": "runs-sync-cliqtomedia-weather-forecast-alerts-export", "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/cliqtomedia~weather-forecast-alerts-export/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-weather-forecast-alerts-export", "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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "maxItems": 10, "type": "array", "description": "Up to 10 points as objects {\"name\": \"New York\", \"lat\": 40.7128, \"lon\": -74.006}, or \"lat,lon\" strings. Latitude −90…90, longitude −180…180, rounded to 4 decimals (about 11 m). The name is only a label copied to every row." }, "provider": { "title": "Forecast provider", "enum": [ "auto", "nws", "met" ], "type": "string", "description": "auto: NWS for points it covers (US states and territories), MET Norway everywhere else. nws: only NWS; other points are reported as not supported. met: MET Norway for every point. Providers are never mixed within a location.", "default": "auto" }, "granularity": { "title": "Granularity", "enum": [ "hourly", "daily" ], "type": "string", "description": "hourly: one row per hour from the current hour. daily: one row per local calendar day with min/max temperature, precipitation total, max wind and gust.", "default": "hourly" }, "hours": { "title": "Hours (hourly mode)", "minimum": 1, "maximum": 48, "type": "integer", "description": "How many hourly rows per location, from the current hour. 1–48.", "default": 24 }, "days": { "title": "Days (daily mode)", "minimum": 1, "maximum": 7, "type": "integer", "description": "How many local days per location. Today is included when at least 6 forecast hours remain; otherwise the run starts tomorrow. 1–7.", "default": 7 }, "includeAlerts": { "title": "Include NWS weather alerts (US only)", "type": "boolean", "description": "Adds a row for each active NWS watch, warning or advisory covering a US point. Not available outside the US. These are NWS weather alerts, not a public emergency-alert service.", "default": true }, "units": { "title": "Units", "enum": [ "metric", "imperial" ], "type": "string", "description": "metric: °C, mm, km/h. imperial: °F, in, mph. Percentages and degrees are the same in both.", "default": "metric" }, "useCache": { "title": "Reuse fresh provider responses", "type": "boolean", "description": "Keeps provider responses in the named key-value store weather-forecast-alerts-cache and reuses them until the provider's expiry time, then revalidates. MET Norway asks clients to do this. Turn off to always fetch anew.", "default": 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 }, "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 } } } } } } } } } }