Skip to main content

History & Climate Data

History API

note

The meteoblue History API is in Beta phase. Major breaking changes to the API are not expected.

This API delivers historical data since 1940 calculated by the ERA5T re-analysis model dataset with a delay of about 8 days. If you query data for time periods that are not covered with ERA5T data, the API will automatically gap-fill the remaining days with meteoblue NEMS model data.

One API call provides a time series of historical weather data for one weather variable and a maximum of 30 years. The default time zone setting is UTC, however, you can also retrieve data in local time by specifying the UTC offset in the API request (see Optional API URL parameters).

Base URL

Example URL that fetches temperature data for Basel for 2022-11-01 to 2022-11-02:

https://my.meteoblue.com/history/point?start=2022-11-01&end=2022-11-02&lat=47.1&lon=8.6&variable=temperature&apikey=DEMOKEY

Mandatory API-URL parameters

ParameterDescriptionExample
startStart date&start=2022-11-01
endEnd date&end=2022-11-02
latLatitude coordinate in WGS84&lat=47.1
lonLongitude coordinate in WGS84&lon=8.6
variableWeather variable to fetch data for&variable=temperature
apikeyValid meteoblue API key&apikey=abc

Optional API-URL parameters

ParameterDescriptionExampleDefaultRemarks
domainWeather model domain&domain=ERA5TERA5TGaps are filled with NEMS model data
Available options are ERA5T and NEMSAUTO
aslLocation height above sea level in meters&asl=279Digital elevation model
utc_offsetTime offset to UTC in hours&utc_offset=3UTC (0)Accepts half hours, ie. &utc_offset=1.5
formatOutput format of the fetched data&format=csvjsonAvailable formats: json, csv
resolutionTime resolution of the data&resolution=dailyhourlyAn aggregation must be specified when querying daily data. Supported time resolutions: hourly, daily, monthly
aggregationAggregation option for daily and monthly data&aggregation=meannoneSupported aggregations: min, max, mean, sum
gapfillDefines whether gap filling is activated&gapfill=falsetrueThe API automatically uses NEMS data for gap filling
If user chooses NEMSAUTO as domain, gapfill is ERA5T

Weather Variables

One API call retrieves data for one weather variable. Some weather variables need additional parameter settings in the API-URL (see column "Additional mandatory parameters"). The API supports various units, which must be specified in the API request (see Weather Variable Units).

VariableHeight LevelAdditional mandatory parameters
temperature2 m above ground-
sealevelpressureMean sea level-
precipitationSurface-
snowfractionSurface-
winddirection10 m above ground-
windspeed10 m above ground-
relativehumidity2 m above ground-
soiltemperature_0to7cm0 to 7 cm below ground-
soilmoisture_0to7cm0 to 7 cm below ground-
skintemperatureSurface-
evapotranspirationSurface-
referenceevapotranspiration_fao2 m above ground-
dewpointtemperature2 m above ground-
wetbulbtemperature2 m above ground-
windspeed_100m100 m above ground-
winddirection_100m100 m above ground-
gustsurface-
windpower100 m above groundturbineid, numberofturbines
totalcloudcoverSurface-
lowcloudsLow clouds up to 2km above ground-
midcloudsMedium high clouds up to 7km above ground-
highcloudsHigh clouds up to 13km above ground-
sunshinetimeSurface-
ghi_backwardsSurface-
dif_backwardsSurface-
dni_backwardsSurface-
pvpower_backwardsSurfaceslope, facing, kwp, power_efficiency, tracker

Weather Variable Units

The API supports all common units as specified in the following table. The desired unit can be defined in the API request. If it is not defined, data will be delivered in the default unit.

Weather VariableExampleDefaultAvailable units
Temperature&temperature=C°CC, K, F
Precipitation&precipitationamount=inchmmmm, inch
Wind speed&windspeed=bftm/sm/s, km/h, mph, kn, bft
Wind direction&winddirection=2chardegreedegree, 2char, 3char
Time formats&timeformat=YMDiso8601iso8601, timestamp_utc, timestamp_ms_utc, YMD, Y-M-D
note

If you have used the previous version of this API (history packages), we recommend requesting NEMSAUTO data to ensure that you have a consistent time series from the same data source. This dataset is built up through archiving the raw weather model output from the NEMS model with the highest spatial resolution once a day (forecast hours 12 through 36).

Sample API-URL to retrieve NEMSAUTO data:

https://my.meteoblue.com/history/point?start=2022-11-01&end=2022-11-02&lat=47.1&lon=8.6&variable=temperature&domain=NEMSAUTO&apikey=APIKEY

Climate Data Packages

The climate data packages are giving back long term averages of the last 35 years to describe the climate conditions of a specific location.

Modelclimate

Example URL: http://my.meteoblue.com/packages/modelclimate-day?lat=47.558&lon=7.573&domain=NEMS4&startdate=2020-01-01&enddate=2020-01-31&apikey=DEMOKEY

The Modelclimate data package contains climate simulation data of the last 35 years.

VariableUnitsDescription
Precipitation monthly meanmm, inch
Temperature monthly mean°C, °F
Temperature mean monthly max°C, °F"Hot days"
Temperature mean monthly min°C, °F"Cold days"
Temperature mean daily max°C, °F
Temperature mean daily min°C, °F
Wind speed monthly meanm/s, km/h, kn, mph, bf
Wind speed mean monthly maxm/s, km/h, kn, mph, bf"Windy days"
Wind speed mean monthly minm/s, km/h, kn, mph, bf
Wind speed mean daily maxm/s, km/h, kn, mph, bf
Wind speed mean daily minm/s, km/h, kn, mph, bf
Precipitation days monthly mean0 - 31Number of days with more than 0.2 mm precipitation
Snow days monthly mean0 - 31
Frost days monthly mean0 - 31Number of days with temperatures below 0°C
Sunshine days monthly mean0 - 31Number of sunshine days per month
Cloudy days monthly mean0 - 31Number of cloudy days per month
Overcast days monthly mean0 - 31Number of overcast days per month

Climate Wind Rose

The Climate Wind Rose data package contains historical data of wind speed and direction over 30 years, and describes how many hours per year the wind blows from the indicated direction and at the indicated speed. The data is accumulated from 30 years of historical weather simulation data from the global meteoblue model NEMSGLOBAL, which has a resolution of 30km.

Example SW: Wind is blowing from South-West (SW) to North-East (NE).

Example URL: http://my.meteoblue.com/yearlyarchive/windrose?lat=47.558&lon=7.573&format=json&apikey=DEMOKEY