{ "openapi": "3.0.1", "info": { "title": "Weather Forecast API - Weather Company Hourly, 15-Day, History", "description": "Weather forecast and historical weather data from The Weather Company API on api.weather.com: current conditions (Currents On Demand), hourly and 3 to 15 day daily forecasts, 24 hour history and 30 day daily summaries by coordinates, airport, postal code or place ID. Bring your own key.", "version": "0.1", "x-build-id": "9KGM7qxTqu5pG8hcU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~weather-forecast-hourly-daily-history-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-weather-forecast-hourly-daily-history-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/nabeelbaghoor~weather-forecast-hourly-daily-history-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-weather-forecast-hourly-daily-history-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/nabeelbaghoor~weather-forecast-hourly-daily-history-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-weather-forecast-hourly-daily-history-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": { "mode": { "title": "What to get", "enum": [ "dailyForecast", "hourlyForecast", "current", "historyHourly", "historyDaily" ], "type": "string", "description": "Daily forecast gives one row per day (3 to 15 days) with day and night parts. Hourly forecast gives one row per hour (6 hours to 15 days). Current conditions gives one row per location from Currents On Demand. Hourly history gives the past 24 hours, one row per hour. Daily history gives the past 30 days, one row per day. Each product and each forecast duration must be on your Weather Company licence.", "default": "dailyForecast" }, "locations": { "title": "Locations", "type": "array", "description": "One location per line: latitude,longitude (33.74,-84.39), a 3 letter IATA airport code (ATL), a 4 letter ICAO airport code (KATL), a postal code with its 2 letter country code (30301:US, SW1A 1AA:GB) or a 64 character Weather Company place ID. Each location is one API request.", "items": { "type": "string" } }, "dailyDuration": { "title": "Daily forecast length", "enum": [ "3day", "5day", "7day", "10day", "15day" ], "type": "string", "description": "Daily forecast only. Each length is a separately licensed product: a key that does not cover it is refused.", "default": "7day" }, "hourlyDuration": { "title": "Hourly forecast length", "enum": [ "6hour", "12hour", "1day", "2day", "3day", "10day", "15day" ], "type": "string", "description": "Hourly forecast only. Each length is a separately licensed product: 2 days is in the Core package, 15 days in the Enhanced Forecast package.", "default": "2day" }, "units": { "title": "Units", "enum": [ "m", "e", "h", "s" ], "type": "string", "description": "Unit system for temperatures, precipitation, wind speed, pressure and visibility.", "default": "m" }, "language": { "title": "Language", "type": "string", "description": "Language code for translated fields such as narratives, weather phrases, day names and wind directions, for example en-US, en-GB, de-DE, fr-FR, es-MX, ja-JP or zh-CN.", "default": "en-US" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most rows this run returns and charges for. A 15 day hourly forecast is 360 rows per location.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Pacing. A rate limit answer is waited out and retried.", "default": 60 }, "apiKey": { "title": "API key", "type": "string", "description": "Your own Weather Company API key for api.weather.com. Stored as a secret and sent only to api.weather.com as the apiKey parameter the API requires; it is never logged. You can instead set the DATA_API_KEY environment secret." } } }, "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 } } } } } } } } } }