Getting Started

Meteomatics provides a REST¹-style API to retrieve historic, current, and forecast data globally. This includes model data and observational data in time series and areal formats. Areal formats are also offered through a WMS²/WFS³-compatible interface. Geographic and time series data can be combined in certain file formats, such as NetCDF.

How Does It Work?

The URL for an API query has the following structure:

api.meteomatics.com/validdatetime/parameters/locations/format?optionals

Your First Query

After you receive your login username and password you can immediately start using and exploring the Weather API.
By clicking on the following example link, for the current air temperature in Berlin, you will be prompted to enter your login details.

https://api.meteomatics.com/__replace__0T00:00:00Z/t_2m:C/52.520551,13.461804/html

You can also use our URL creator tool which will guide you through the step by step process.
Looking at the example from above:

api.meteomatics.com/__replace__0T00:00:00Z/t_2m:C/52.520551,13.461804/html

__replace__0T00:00:00Z - current date and time (Z is the time zone designator for UTC time)
t_2m:C - parameter with units (temperature at two meters above ground in degrees Celsius)
52.520551,13.461804 - latitude, longitude (in decimal degrees)
html - output format

For more details concerning parameters, locations and format - click here for more information about the structure.

Use a Time Interval

Let’s get the temperature for a ten day interval with temporal increments of one day:

api.meteomatics.com/__replace__0T00:00:00Z--__replace__3T00:00:00Z:PT1H/t_2m:C/52.520551,13.461804/html

start date: __replace__0T00:00:00Z
end date: __replace__3T00:00:00Z
time step: PT1H - time step (1 hour)

Click here for a detailed time description

Let's Add More Parameters

For more than one parameter type them separated by commas:

api.meteomatics.com/__replace__0T00:00:00Z--__replace__3T00:00:00Z:PT1H/t_2m:C,precip_1h:mm,wind_speed_10m:ms/52.520551,13.461804/html

t_2m:C - temperature at two meters in degree Celsius
precip_1h:mm - precipitation during the last hour in mm
wind_speed_10m:ms - wind speed at 10 m in m/s

Click here for more available parameters.

Get Parameters On a Grid

Interested in a specific area? No problem, just adapt the coordinates:

api.meteomatics.com/__replace__0T00:00:00Z/t_2m:C/50,10_40,20:0.02,0.04/html

50,10 - latitude max, longitude min (upper left corner of the area)
40,20 - latitude min, longitude max (lower right corner of the area)
0.02,0.04 - resolution (latitude direction: 0.02°, longitude direction: 0.04°)
html - output format (png or csv also possible)

Click here for a detailed coordinates description.

Output Formats

You can change the output format to your desired format. Just replace html in the query above:

png, xml, JSON, netcdf...

api.meteomatics.com/__replace__0T00:00:00Z--__replace__3T00:00:00Z:PT1H/t_2m:C/52.520551,13.461804/json

json - json format

Click here for available formats.

Need some help?

We are continuously innovating and perfecting our API, to ensure we deliver superior accuracy and ease of use. Thus, we have designed the URL Creator to help you build an API request, by simplifying the process of requesting weather data.
Checkout the URL Creator