Getting Started

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 then also scroll down to 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.

URL Creator

Get A Subscription

You can get a subscription for the Meteomatics Weather API at the shop or by directly contacting us.

Email: api@meteomatics.com.

Phone (Switzerland): +41 (0) 71 272 66 50

Phone (Germany): +49 (0) 30 200 74 280

Phone (France): +33 (0) 7 89 57 22 32

Get Support

For any questions, please write an email to support@meteomatics.com.