ClimateAI Weather API (1.0.0)

Download OpenAPI specification:Download

API Support: developers@climate.ai URL: https://api.climate.ai/

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

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"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/climatology/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"property1": 0,
"property2": 0
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
}
}
}
}
]
}

Get climatology data for given location id

SecurityAPI Key

Request

path Parameters

required

string

query Parameters

var	string Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/climatology/location/{id}

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"property1": 0,
"property2": 0
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
}
}
}
}
]
}

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"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/seasonal/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

Get seasonal forecast data for given location id

SecurityAPI Key

Request

path Parameters

required

string

query Parameters

var	string Enum: "evapotranspiration" "humidity" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/seasonal/location/{id}/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

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"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/short-term/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

Get short-term forecast data for given location id

SecurityAPI Key

Request

path Parameters

required

string

query Parameters

var	string Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/short-term/location/{id}/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

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"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/subseasonal/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

Get subseasonal forecast data for given location id

SecurityAPI Key

Request

path Parameters

required

string

query Parameters

var	string Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/forecast/subseasonal/location/{id}/

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"clim_prob_0.00-0.33": 0.53,
"clim_prob_0.33-0.67": 0.1,
"clim_prob_0.67-1.00": 0.37
},
"quantile": {"quantile_0.05": 7.59,
"quantile_0.25": 15.44,
"quantile_0.50": 21.16,
"quantile_0.75": 26.39,
"quantile_0.95": 31.5
},
"ensemble_mean": 20.53
}
}
}
]
}

History

History related operations

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"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/history

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"property1": 0,
"property2": 0
},
"quantile": {"property1": 0,
"property2": 0
},
"values": 0
}
}
}
]
}

Get history data for given location id

SecurityAPI Key

Request

path Parameters

required

string

query Parameters

var	string Enum: "evapotranspiration" "humidity" "soil_moisture" "solar_radiation" "soil_temperature" "temp_mean" "temp_max" "temp_min" "precipitation" "wind_speed"

Responses

200

Success

400

Validation Error

404

Data Not Found

500

Internal server error.

get/history/location/{id}

Request samples

Node.js
JavaScript
Python
Java
Go

Response samples

application/json

{"meta": {"variables": ["evapotranspiration",
"humidity",
"soil_moisture",
"solar_radiation",
"soil_temperature",
"temp_mean",
"temp_max",
"temp_min",
"precipitation",
"wind_speed"
],
"granularity": "month",
"location": {"latitude": 39.7,
"longitude": -100.1
},
"data_version": "alpha",
"statistics": ["ensemble_mean",
"quantile_0.05",
"quantile_0.25",
"quantile_0.50",
"quantile_0.75",
"quantile_0.95",
"clim_prob_0.00-0.33",
"clim_prob_0.33-0.67",
"clim_prob_0.67-1.00"
],
"downscaling_outcome": "Success"
},
"data": [{"date": "2022-09-01",
"type": "Monthly Seasonal Forecast",
"id": 0,
"attributes": {"*": {"units": "mm",
"probability": {"property1": 0,
"property2": 0
},
"quantile": {"property1": 0,
"property2": 0
},
"values": 0
}
}
}
]
}

Datasets

ClimateAI currently supports two datasets via its weather API, Seasonal and Subseasonal datasets. Below you will find two tables with the information about both datasets and how to query individual variables.

Queryable Variables

Variable	Query Value	Seasonal	Subseasonal	Short Term
Mean Temperature	temp_mean	✔	✔	✖
Max Temperature	temp_max	✔	✔	✖
Minimum Temperature	temp_min	✔	✔	✖
Precipitation	precipitation	✔	✔	✖
Soil Temperature	soil_temperature	✔	✔	✖
Relative Humidity	humidity	✔	✔	✖
Evapotransporation	evapotranspiration	✔	✔	✖
Solar Radiation	solar_radiation	✔	✔	✖
Soil Moisture	soil_moisture	✖	✔	✖
Wind Speed	wind_speed	✔	✔	✖

Seasonal Dataset

Variable	Available	Bias Corrected	Granularities	Resolution	Statistics
Temperature	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Precipitation	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Temperature	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Relative Humidity	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Evapotranspiration	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Solar Radiation	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Moisture	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Wind Speed	✔	✔	monthly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]

Subseasonal Dataset

Variable	Available	Bias Corrected	Granularities	Resolution	Statistics
Temperature	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Precipitation	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Soil Temperature	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Relative Humidity	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Evapotranspiration	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Solar Radiation	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]
Wind Speed	✔	✔	weekly	0.25°	ensemble mean and [0.05, 0.25, 0.50, 0.75, 0.95] and [0.00-0.33,0.33-0.67, 0.67-1.0]