# Open-Meteo Global Weather Forecast Scraper (`parseforge/open-meteo-weather-scraper`) Actor

Pull global weather forecasts and historical climate data. Returns hourly or daily temperature, precipitation, humidity, wind, cloud cover, pressure, snowfall, UV index for any lat/lng worldwide. Up to 16 days forecast or 80 years historical. No key required.

- **URL**: https://apify.com/parseforge/open-meteo-weather-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Travel, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🌤️ Open-Meteo Global Weather Forecast Scraper

> 🚀 **Pull global weather forecasts and historical climate data: temperature, precipitation, wind, UV, cloud cover for any lat/lng worldwide.**

> 🕒 **Last updated:** 2026-05-07 · **📊 22 fields** per record · **Worldwide forecast** + **80 years historical** · hourly or daily granularity · temperature, precipitation, wind, humidity, cloud, pressure, UV

The **Open-Meteo Global Weather Forecast Scraper** pulls weather and climate data from Open-Meteo, a free open-data weather API with no key required. Output includes temperature (max/min/apparent), precipitation, rain, snowfall, humidity, dew point, wind speed/gusts/direction, cloud cover, pressure, UV index, sunrise/sunset, and weather codes for any latitude/longitude.

Two modes: **forecast** (next 16 days globally) or **historical** (1940 to present). Daily granularity returns one row per day per location with summary stats; hourly granularity returns 24 rows per day with intra-day readings. Multi-location runs supported via lat/lng list. Pure open data — no API key, no quota.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Travel platforms, agriculture tech, energy traders, logistics, climate researchers, journalists, ML pipelines | Travel-app forecasts, agriculture/crop modeling, energy demand forecasting, climate research, news visualizations |

---

### 📋 What the Open-Meteo Global Weather Forecast Scraper does

Five filtering workflows in a single run:

- 📅 **Forecast mode.** Next 16 days for any lat/lng worldwide.
- 📚 **Historical mode.** 1940 to present from ERA5 reanalysis.
- ⏱️ **Daily or hourly.** Daily summaries (1 row/day) or hourly readings (24 rows/day).
- 🌍 **Multi-location.** Pass any number of lat/lng pairs in a single run.
- 🌡️ **Multi-unit.** Celsius/Fahrenheit, km/h winds, mm precipitation.

> 💡 **Why it matters:** clean, server-side filtering and fresh data on every run.

---
### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan up to 1,000,000.</td></tr>
<tr><td><code>mode</code></td><td>string</td><td><code>"forecast"</code></td><td>forecast or historical.</td></tr>
<tr><td><code>locations</code></td><td>string</td><td><code>newline list</code></td><td>One lat,lng per line.</td></tr>
<tr><td><code>startDate</code></td><td>string</td><td><code>""</code></td><td>YYYY-MM-DD (historical mode).</td></tr>
<tr><td><code>endDate</code></td><td>string</td><td><code>""</code></td><td>YYYY-MM-DD (historical mode).</td></tr>
<tr><td><code>granularity</code></td><td>string</td><td><code>"daily"</code></td><td>daily or hourly.</td></tr>
<tr><td><code>temperatureUnit</code></td><td>string</td><td><code>"celsius"</code></td><td>celsius or fahrenheit.</td></tr>
</tbody>
</table>

**Example: 7-day forecast for 3 cities.**

```json
{
    "maxItems": 30,
    "mode": "forecast",
    "locations": "52.52,13.41\n40.71,-74.01\n35.68,139.65",
    "granularity": "daily"
}
````

**Example: Berlin historical 2020 hourly.**

```json
{
    "maxItems": 200,
    "mode": "historical",
    "locations": "52.52,13.41",
    "startDate": "2020-01-01",
    "endDate": "2020-01-08",
    "granularity": "hourly"
}
```

***

### 📊 Output

Each record contains **22 fields**. Download as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 📅 `timestamp` | string | `"2026-05-07"` |
| 🌍 `latitude` | number | `52.52` |
| 🌍 `longitude` | number | `13.41` |
| 🕒 `timezone` | string | `"Europe/Berlin"` |
| 📐 `elevation` | number | `38` |
| 🌡️ `temperatureMax` | number | `18.5` |
| 🌡️ `temperatureMin` | number | `9.2` |
| 💧 `precipitationSum` | number | `2.4` |
| 🌧️ `rainSum` | number | `2.4` |
| ❄️ `snowfallSum` | number | `0` |
| 💨 `windSpeedMax` | number | `18.5` |
| 💨 `windGustMax` | number | `32.4` |
| 🌅 `sunrise` | string | `"2026-05-07T05:32"` |
| 🌇 `sunset` | string | `"2026-05-07T20:48"` |
| ☀️ `uvIndexMax` | number | `6.2` |
| ☁️ `weatherCode` | number | `61` |

#### 📦 Sample records

<details>
<summary><strong>☀️ Berlin daily</strong></summary>

```json
{"timestamp":"2026-05-07","latitude":52.52,"longitude":13.41,"timezone":"Europe/Berlin","temperatureMax":18.5,"temperatureMin":9.2,"precipitationSum":2.4,"windSpeedMax":18.5,"sunrise":"2026-05-07T05:32","sunset":"2026-05-07T20:48"}
```

</details>

<details>
<summary><strong>🌃 NYC hourly</strong></summary>

```json
{"timestamp":"2026-05-07T15:00","latitude":40.71,"longitude":-74.01,"temperature_2m":21.3,"precipitation":0,"windspeed_10m":12.5}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🌍 | **Worldwide coverage.** Any lat/lng on Earth. |
| 📚 | **80 years historical.** ERA5 reanalysis from 1940 to present. |
| ⏱️ | **Daily or hourly.** Pick the right granularity per use case. |
| 🆓 | **No API key.** Pure open data with no quota. |
| ⚡ | **Fast.** 100 records in under 30 seconds. |

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ This Actor** | $5 free credit | **Worldwide** | Live per run | mode, locations, granularity, units | ⚡ 2 min |
| OpenWeatherMap | $$ | Worldwide | Live | Yes | 🐢 API key |
| WeatherAPI | $$ | Worldwide | Live | Yes | 🐢 API key |
| Manual NOAA scraping | Free | US-leaning | Variable | DIY | 🐢 Days |

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Find the Open-Meteo Global Weather Forecast Scraper on the Apify Store.
3. 🎯 **Set input.** Pick filters and `maxItems`.
4. 🚀 **Run it.** Click **Start**.
5. 📥 **Download.** Grab results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### ✈️ Travel + Tourism

- Trip-planner forecasts
- City pages with seasonal stats
- Best-time-to-visit indicators
- Beach/ski-resort weather

</td>
<td width="50%" valign="top">

#### 🌾 Agriculture + Energy

- Crop modeling with temp + precip
- Energy demand forecasting
- Solar generation by UV index
- Wind farm power forecasting

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 📰 News + Visualizations

- Heatwave story visualizations
- Climate-change overlays
- Weather-event explainers
- Year-in-review climate summaries

</td>
<td width="50%" valign="top">

#### 🤖 ML + Research

- Train weather-prediction models
- Build climate-change features
- Power agriculture/energy dashboards
- Cross-train with historical reanalysis

</td>
</tr>
</table>

***

### 🔌 Automating Open-Meteo Global Weather Forecast Scraper

Control the scraper programmatically:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Climate-research datasets
- Reproducible weather snapshots
- Course materials
- Cross-region climate studies

</td>
<td width="50%">

#### 🎨 Personal and creative

- Personal weather dashboards
- Garden/outdoor planning apps
- Newsletter content
- Hobbyist climate analysis

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Disaster-response planning
- Climate-justice research
- Open-data weather services
- Civic-tech projects

</td>
<td width="50%">

#### 🧪 Experimentation

- Train weather forecasting models
- Prototype weather-aware agents
- Build climate visualizations
- Test forecasting libraries

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Open-Meteo%20Global%20Weather%20Forecast%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Open-Meteo%20Global%20Weather%20Forecast%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Open-Meteo%20Global%20Weather%20Forecast%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Open-Meteo%20Global%20Weather%20Forecast%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Pick mode (forecast or historical) and supply lat/lng locations. The Actor calls Open-Meteo and emits one row per day or per hour per location.

#### 📊 How many fields per record?

Up to 22 daily fields, plus weather code, sunrise/sunset, and UV index. Hourly mode returns ~13 columns per row.

#### 📅 What's the historical range?

1940 to present. Open-Meteo's archive is backed by ERA5 reanalysis.

#### 🌍 What lat/lng resolution?

Forecast = ~1km grid (down to building-level for some areas). Historical = ~10km ERA5 grid.

#### 🆓 Is the API really free?

Yes. Open-Meteo is non-profit. No API key for personal/non-commercial use; high-volume commercial users can subscribe.

#### 🔁 Can I schedule runs?

Yes. Schedule daily for fresh forecasts.

#### ⚖️ Is this data free to use commercially?

Yes for moderate volume. For high-volume commercial use, see Open-Meteo's pricing for guaranteed-quota plans.

#### 💳 Do I need a paid Apify plan?

No. The free plan covers preview runs.

#### 🆘 What if a run fails?

Apify retries transient errors. Per-location failures are logged and other locations continue.

#### ☁️ What does weatherCode mean?

WMO standard weather codes. 0=clear, 1-3=mostly clear, 45-48=fog, 51-67=drizzle/rain, 71-77=snow, 80+=showers/storms.

***

### 🔌 Integrate with any app

Open-Meteo Global Weather Forecast Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets to Sheets

***

### 🔗 Recommended Actors

- [**🌍 REST Countries**](https://apify.com/parseforge/rest-countries-scraper) - Country reference data with capital, currency, flag
- [**🌐 GeoNames Places + Postal Codes**](https://apify.com/parseforge/geonames-places-scraper) - 12M+ places with admin hierarchy
- [**🌍 Public Holidays Worldwide**](https://apify.com/parseforge/public-holidays-scraper) - Public holidays for 100+ countries
- [**🏥 WHO Global Health Indicators**](https://apify.com/parseforge/who-gho-health-indicators-scraper) - 9,000+ WHO health metrics
- [**🌏 World Bank Funded Projects**](https://apify.com/parseforge/worldbank-projects-scraper) - World Bank-financed development projects

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Open-Meteo, ECMWF, NOAA, or any contributing weather agency. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.

# Actor input Schema

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `mode` (type: `string`):

Pick forecast or historical archive.

## `locations` (type: `string`):

One `latitude,longitude` per line. Each location returns its own dataset row(s). Examples: `52.52,13.41` (Berlin), `40.71,-74.01` (NYC), `35.68,139.65` (Tokyo).

## `startDate` (type: `string`):

YYYY-MM-DD. Only for historical mode.

## `endDate` (type: `string`):

YYYY-MM-DD. Only for historical mode.

## `granularity` (type: `string`):

Hourly produces 24 rows per day per location; daily produces 1 row per day.

## `temperatureUnit` (type: `string`):

Celsius or Fahrenheit.

## Actor input object example

```json
{
  "maxItems": 10,
  "mode": "forecast",
  "locations": "52.52,13.41\n40.71,-74.01\n35.68,139.65",
  "startDate": "2024-01-01",
  "endDate": "2024-01-07",
  "granularity": "daily",
  "temperatureUnit": "celsius"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "mode": "forecast",
    "locations": `52.52,13.41
40.71,-74.01
35.68,139.65`,
    "startDate": "2024-01-01",
    "endDate": "2024-01-07",
    "granularity": "daily",
    "temperatureUnit": "celsius"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/open-meteo-weather-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "mode": "forecast",
    "locations": """52.52,13.41
40.71,-74.01
35.68,139.65""",
    "startDate": "2024-01-01",
    "endDate": "2024-01-07",
    "granularity": "daily",
    "temperatureUnit": "celsius",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/open-meteo-weather-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "mode": "forecast",
  "locations": "52.52,13.41\\n40.71,-74.01\\n35.68,139.65",
  "startDate": "2024-01-01",
  "endDate": "2024-01-07",
  "granularity": "daily",
  "temperatureUnit": "celsius"
}' |
apify call parseforge/open-meteo-weather-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/open-meteo-weather-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Open-Meteo Global Weather Forecast Scraper",
        "description": "Pull global weather forecasts and historical climate data. Returns hourly or daily temperature, precipitation, humidity, wind, cloud cover, pressure, snowfall, UV index for any lat/lng worldwide. Up to 16 days forecast or 80 years historical. No key required.",
        "version": "1.0",
        "x-build-id": "mpe9AMqrK1FWpLSxa"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~open-meteo-weather-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-open-meteo-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/parseforge~open-meteo-weather-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-open-meteo-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/parseforge~open-meteo-weather-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-open-meteo-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": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "forecast",
                            "historical"
                        ],
                        "type": "string",
                        "description": "Pick forecast or historical archive.",
                        "default": "forecast"
                    },
                    "locations": {
                        "title": "Locations (lat,lng per line)",
                        "type": "string",
                        "description": "One `latitude,longitude` per line. Each location returns its own dataset row(s). Examples: `52.52,13.41` (Berlin), `40.71,-74.01` (NYC), `35.68,139.65` (Tokyo)."
                    },
                    "startDate": {
                        "title": "Start date (historical mode)",
                        "type": "string",
                        "description": "YYYY-MM-DD. Only for historical mode."
                    },
                    "endDate": {
                        "title": "End date (historical mode)",
                        "type": "string",
                        "description": "YYYY-MM-DD. Only for historical mode."
                    },
                    "granularity": {
                        "title": "Granularity",
                        "enum": [
                            "daily",
                            "hourly"
                        ],
                        "type": "string",
                        "description": "Hourly produces 24 rows per day per location; daily produces 1 row per day.",
                        "default": "daily"
                    },
                    "temperatureUnit": {
                        "title": "Temperature unit",
                        "enum": [
                            "celsius",
                            "fahrenheit"
                        ],
                        "type": "string",
                        "description": "Celsius or Fahrenheit.",
                        "default": "celsius"
                    }
                }
            },
            "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
