ClimateAI Weather API (1.0.0)

Download OpenAPI specification:Download

OpenAPI Specification for the ClimateAI API We provide all kind of solutions for building your models. There is weather data such as climatology, historical and forecast data so you can feed your models using the best data available worldwide.

Authentication

We currently support API Key as a form of authentication for all of our endpoints. Contact one of our sales team member to get your API key so you can start trying out our service.

API Key

Security Scheme Type: API Key
Header parameter name: X-Api-Key

History

History related operations, last 366 days of data

Get history data for given coordinates

SecurityAPI Key
Request
query Parameters
lat
required
string
lon
required
string
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/history
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get history data for given location id

SecurityAPI Key
Request
path Parameters
id
required
string
query Parameters
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/history/location/{id}
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Climatology

Climatology related operations

Get climatology data for given coordinates

SecurityAPI Key
Request
query Parameters
lat
required
string
lon
required
string
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
granularity
string
Enum: "daily" "weekly" "monthly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/climatology/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get climatology data for given location id

SecurityAPI Key
Request
path Parameters
id
required
string
query Parameters
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
granularity
string
Enum: "daily" "weekly" "monthly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/climatology/location/{id}
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Forecast

Forecast related operations

Get seasonal forecast data for given coordinates

SecurityAPI Key
Request
query Parameters
lat
required
string
lon
required
string
var
string
Enum: "evapotranspiration" "humidity" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"
granularity
string
Enum: "daily" "monthly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/seasonal/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get seasonal forecast data for given location id

SecurityAPI Key
Request
path Parameters
id
required
string
query Parameters
var
string
Enum: "evapotranspiration" "humidity" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"
granularity
string
Enum: "daily" "monthly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/seasonal/location/{id}/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get short-term forecast data for given coordinates

SecurityAPI Key
Request
query Parameters
lat
required
string
lon
required
string
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/short-term/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get short-term forecast data for given location id

SecurityAPI Key
Request
path Parameters
id
required
string
query Parameters
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed" "max_wind_speed" "max_wind_gust"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/short-term/location/{id}/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get subseasonal forecast data for given coordinates

SecurityAPI Key
Request
query Parameters
lat
required
string
lon
required
string
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"
granularity
string
Enum: "daily" "weekly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/subseasonal/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Get subseasonal forecast data for given location id

SecurityAPI Key
Request
path Parameters
id
required
string
query Parameters
var
string
Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"
granularity
string
Enum: "daily" "weekly"
Responses
200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/subseasonal/location/{id}/
Request samples
Response samples
application/json
{
  • "meta": {
    },
  • "data": [
    ]
}

Datasets

ClimateAI currently supports five datasets via its weather API, History, Climatology, Short-term Forecast, Subseasonal Forecast and Seasonal Forecast datasets. Below you will find tables with the information about datasets and how to query individual variables.

Queryable Variables

Variable Query Value Units History Climatology Short-Term Subseasonal Seasonal
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

History

Variable Granularities Resolution Statistics
Mean Temperature daily 0.25° or 0.0083°** values
Max Temperature daily 0.25° or 0.0083°** values
Min Temperature daily 0.25° or 0.0083°** values
Precipitation daily 0.25° values
Soil Temperature daily 0.25° values
Relative Humidity daily 0.25° values
Evapotranspiration daily 0.25° values
Solar Radiation daily 0.25° or 0.0083°** values
Soil Moisture daily 0.25° values
Mean Wind Speed daily 0.25° values
Max Wind Speed daily 0.25° values
Max Wind Gust daily 0.25° values

**Locations can be downscaled to this resolution on a per request basis. Contact sales team for more information. Not done by default.

Climatology

Variable Granularities Resolution Statistics
Mean Temperature daily, weekly, monthly 0.25° or 0.0083°** quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Temperature daily, weekly, monthly 0.25° or 0.0083°** quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Min Temperature daily, weekly, monthly 0.25° or 0.0083°** quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Precipitation daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Soil Temperature daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Relative Humidity daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Evapotranspiration daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Solar Radiation daily, weekly, monthly 0.25° or 0.0083°** quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Soil Moisture daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Mean Wind Speed daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Wind Speed daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Wind Gust daily, weekly, monthly 0.25° quantiles [0.05, 0.25, 0.50, 0.75, 0.95]

**Locations can be downscaled to this resolution on a per request basis. Contact sales team for more information. Not done by default.

Short-term Forecast

Variable Granularities Resolution Statistics
Mean Temperature daily 0.25° or 0.0083°** ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Temperature daily 0.25° or 0.0083°** ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Min Temperature daily 0.25° or 0.0083°** ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Precipitation daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Soil Temperature daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Relative Humidity daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Evapotranspiration daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Solar Radiation daily 0.25° or 0.0083°** ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Soil Moisture daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Mean Wind Speed daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Wind Speed daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
Max Wind Gust* daily 0.25° ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]

*Max Wind Gust is available only for the first 10 days of the forecast.

**Locations can be downscaled to this resolution on a per request basis. Contact sales team for more information. Not done by default.

Subseasonal Forecast

Variable Granularities Resolution Statistics
Mean Temperature daily
weekly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Max Temperature daily
weekly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Min Temperature daily
weekly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Precipitation daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Temperature daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Relative Humidity daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Evapotranspiration daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Solar Radiation daily
weekly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Moisture daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Mean Wind Speed daily
weekly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
weekly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]

**Locations can be downscaled to this resolution on a per location basis. Contact sales team for more information. Not done by default.

Seasonal Forecast

Variable Granularities Resolution Statistics
Mean Temperature daily
monthly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Max Temperature daily
monthly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Min Temperature daily
monthly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Precipitation daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Temperature daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Relative Humidity daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Evapotranspiration daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Solar Radiation daily
monthly
0.25° or 0.0083°** daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Moisture daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]
Mean Wind Speed daily
monthly
0.25° daily: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95]
monthly: ensemble mean and quantiles [0.05, 0.25, 0.50, 0.75, 0.95] and probabilistic ranges [0.00-0.33,0.33-0.67, 0.67-1.0]

**Locations can be downscaled to this resolution on a per request basis. Contact sales team for more information. Not done by default.