When you've signed up for an account and got your API key, you can request data from one of the available endpoints using a GET request. Requests look like this:
For example, if you want to get METAR information for Aéroport international de Madrid-Barajas (LEMD), your request looks like this:
Currently, the following endpoints are available. Their outputs are discussed in the section "Data reference":
|metar||Get a raw and decoded METAR, with airport information, weather station info, runway directions and cross/headwind. Both current and historical METAR information.|
|taf||Get the current TAF, raw and decoded per hour|
|airports||Get a list of airports, with latitude/longitude and METAR and TAF availability|
|metar-history||Get historical METARs of an airport|
The current version of this API is
You can just provide this value in all the calls you make.
Certain metrics may be removed or renamed in the future. Just provide the value above in the calls you make. This way we know when you implemented the API and which information your application expects.
When a new version of the API is released, your application won't break. We'll keep deprecated metrics where they are.
Airports, cities and other string data is available in multiple languages.
For example, LEMD is "Adolfo Suárez Madrid-Barajas Airport" in English, but "Luchthaven Madrid-Barajas" in Dutch. With the locale parameter you can request in which language you want to have the result.
Note that this has no effect on numerical values. You'll find in the data reference that wind speeds are always in knots, heights always in feet, etc.
Available locales are:
You can add
&test=1 to the request if you want the JSON data in a human readable format. Every attribute will be on a new line.