Getting Started

Authenticate, browse the API's current and legacy endpoint families, and make your first request.

The ClimateAI Weather API provides global weather and climate data accessible by latitude and longitude: historical data, climatological baselines, and probabilistic forecasts from short-term through seasonal horizons.

Authentication

All requests require an API key in the X-Api-Key header. Request a key from sales@climate.ai.

X-Api-Key: <YOUR_API_KEY>

See Your first request below for a complete example.

Endpoint families

The API has two generations of endpoints. The current endpoints are recommended for new integrations. The legacy endpoints remain fully supported for the foreseeable future for customers already integrated against them; see Migration for how to move from legacy to current.

Family	Current (recommended)	Legacy	What it returns
Forecast	`/v2/forecast`, `/v2/forecast/statistics`	`/v1/forecast/short-term`, `/v1/forecast/subseasonal`, `/v1/forecast/seasonal`	Forecast from today through ~6 months. The current endpoints return a single continuous timeline; legacy endpoints split it across three horizons.
History	`/v2/history`	`/v1/history`	Historical data. The current endpoint covers 30+ years (1995–present); legacy covers a rolling 12 months.
Climatology	(none yet, see coming soon)	`/v1/climatology`	Long-term statistical distributions over a fixed 30-year reference period (1993–2022).

Legacy paths are shown in their /v1/-prefixed canonical form; the unprefixed form (e.g. /forecast/short-term) is an alias and continues to work for existing integrations.

Growing Degree Days, Alerts, and a new flexible Climatology endpoint are coming soon.

Your first request

curl -X GET \
  "https://api-prod.climate.ai/weather/v2/history" \
  -G \
  -d "lat=37.7" \
  -d "lon=-122.4" \
  -d "var=temp_mean" \
  -d "start_date=2024-01-01" \
  -d "end_date=2024-12-31" \
  -H "X-Api-Key: <YOUR_API_KEY>"

Response:

{
  "meta": {
    "variables": ["temp_mean"],
    "granularity": "daily",
    "location": { "latitude": 37.7, "longitude": -122.4 }
  },
  "data": {
    "temp_mean": {
      "units": "degrees_C",
      "downscaled": true,
      "values": { "2024-01-01": 11.4, "2024-01-02": 12.1, "...": "..." }
    }
  }
}

Data products