Getting Started With Meteomatics Weather API

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/2022-09-28T00: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/2022-09-28T00:00:00Z/t_2m:C/52.520551,13.461804/html

2022-09-28T00: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 three day interval with temporal increments of one hour:

api.meteomatics.com/2022-09-28T00:00:00Z--2022-10-01T00:00:00Z:PT1H/t_2m:C/52.520551,13.461804/html

start date: 2022-09-28T00:00:00Z
end date: 2022-10-01T00: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/2022-09-28T00:00:00Z--2022-10-01T00: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. For example, let’s get the coordinates of a rectangle with a fixed resolution:

api.meteomatics.com/2022-09-28T00: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 rectangle)
40,20 - latitude min, longitude max (lower right corner of the rectangle)
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/2022-09-28T00:00:00Z--2022-10-01T00: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

Get A Subscription

You can get a subscription for the Meteomatics Weather API on this page or by directly contacting us.

Check out our API packages Sign up for a free API test account

Email: [email protected].

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

Phone (USA): +1 (0) 814 689 99 31

Get Support

For any questions, please write an email to [email protected].

Footnotes

Representational state transfer: https://en.wikipedia.org/wiki/Representational_state_transfer
Web Map Service: https://www.ogc.org/standards/wms
Web Feature Service: https://www.ogc.org/standards/wfs

We value your business and are proud to be a reliable partner. Our API is online since May 2015 and in the last year has