Getting Started

Welcome to the ClimateAI Weather API. This guide will help you understand the datasets we provide, how to authenticate, and how to start making requests.

Overview

ClimateAI delivers high-quality, global-scale weather and climate datasets that you can use to build models and applications.
Our API supports historical, climatological, and forecast data, with multiple temporal granularities and spatial resolutions.

Use cases include:

Agriculture and crop modeling
Risk and resilience planning
Climate research
Supply chain forecasting

Authentication

All endpoints require an API Key.

Contact the ClimateAI sales team at sales@climate.ai to request a key.
Include the key in the X-Api-Key header of every request:

GET /history?lat=37.96&lon=-40.98&var=temp_mean
Host: https://api-prod.climate.ai/weather
X-Api-Key: <YOUR_API_KEY>

Datasets

ClimateAI currently supports five datasets via its weather API:

History – Last 366 days of observed/reanalysis data
Climatology – Long-term distributions and quantiles
Short-term Forecast – 15-day forecasts
Subseasonal Forecast – 2–6 week forecasts
Seasonal Forecast – 1–6 month forecasts

Queryable Variables

Variable	Query Value	Units
Mean Temperature	temp_mean	°C
Max Temperature	temp_max	°C
Min Temperature	temp_min	°C
Precipitation	precipitation	mm
Soil Temperature	soil_temperature	°C
Relative Humidity	humidity	%
Evapotranspiration	evapotranspiration	mm
Solar Radiation	solar_radiation	W/m²
Soil Moisture	soil_moisture	%
Mean Wind Speed	wind_speed	km/h
Max Wind Speed	max_wind_speed	km/h
Max Wind Gust	max_wind_gust	km/h

Some variables are not available across all datasets. Refer to Dataset details .

Making Your First Request

Example: Fetch mean daily temperature from the History dataset:

curl -X GET "https://api-prod.climate.ai/weather/history?lat=37.96&lon=-40.98&var=temp_mean" \
  -H "X-Api-Key: <YOUR_API_KEY>"

Response (simplified):

{
  "meta": {
    "variables": ["temp_mean"],
    "granularity": "daily",
    "location": { "latitude": 37.7, "longitude": -122.4 }
  },
  "data": [
    {
      "date": "2024-08-26",
      "attributes": {
        "temp_mean": { "units": "degrees_C", "values": 29.86 }
      }
    }
  ]
}

Next Steps

Explore the API Reference for full endpoint details.
Review dataset coverage and variable availability to design your queries.
Contact customersuccess@climate.ai for support.