{ "openapi": "3.0.1", "info": { "title": "Historical Weather Scraper — Daily & Hourly Since 1940", "description": "Download historical weather for any place or coordinates: daily or hourly temperature, precipitation, wind and more, back to 1940. One tidy row per day or hour, exported as JSON, CSV or Excel for research, energy, agriculture and analytics.", "version": "1.0", "x-build-id": "FytB6s7XqTfmoHZni" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hipersoft~historical-weather-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hipersoft-historical-weather-scraper", "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/hipersoft~historical-weather-scraper/runs": { "post": { "operationId": "runs-sync-hipersoft-historical-weather-scraper", "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/hipersoft~historical-weather-scraper/run-sync": { "post": { "operationId": "run-sync-hipersoft-historical-weather-scraper", "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": { "places": { "title": "Places (by name)", "type": "array", "description": "Place names to look up, one per line (e.g. \"Singapore\", \"London\", \"New York\"). Each name is resolved to coordinates automatically. Use this OR the Locations field below (you can combine both).", "items": { "type": "string" } }, "locations": { "title": "Locations (by coordinates)", "type": "array", "description": "Exact coordinates as a list of objects: {\"name\": \"Farm A\", \"latitude\": 1.29, \"longitude\": 103.85}. The optional name is used as a label; latitude and longitude are required." }, "startDate": { "title": "Start date", "type": "string", "description": "First day of history to fetch, as YYYY-MM-DD (e.g. 2024-01-01). Data is available from 1940 onward.", "default": "2024-01-01" }, "endDate": { "title": "End date", "type": "string", "description": "Last day of history to fetch, as YYYY-MM-DD. History runs up to a few days before today.", "default": "2024-12-31" }, "granularity": { "title": "Granularity", "enum": [ "daily", "hourly" ], "type": "string", "description": "Daily gives one row per day (with your daily variables). Hourly gives one row per hour (with your hourly variables) — larger output.", "default": "daily" }, "daily": { "title": "Daily variables", "type": "array", "description": "Daily variables (used when Granularity is Daily), one per line. Options include temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, rain_sum, snowfall_sum, windspeed_10m_max, windgusts_10m_max, shortwave_radiation_sum, et0_fao_evapotranspiration. Leave as-is for a sensible default set.", "default": [ "temperature_2m_max", "temperature_2m_min", "temperature_2m_mean", "precipitation_sum", "windspeed_10m_max" ], "items": { "type": "string" } }, "hourly": { "title": "Hourly variables", "type": "array", "description": "Hourly variables (used when Granularity is Hourly), one per line (e.g. temperature_2m, relativehumidity_2m, precipitation, windspeed_10m, cloudcover, surface_pressure).", "default": [ "temperature_2m", "precipitation", "windspeed_10m" ], "items": { "type": "string" } }, "timezone": { "title": "Timezone", "type": "string", "description": "Timezone for the returned timestamps. Use \"auto\" to match each location's local time, or an IANA name like \"Asia/Singapore\" or \"UTC\".", "default": "auto" }, "maxItems": { "title": "Max rows", "minimum": 0, "type": "integer", "description": "Maximum rows to collect across all locations (0 = no limit).", "default": 0 }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Optional proxy settings for the run. Not required — the data is fetched over plain HTTP.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }