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