Supported providers#
The key characteristics of the supported providers can be found in the following table.
Provider |
Region |
Access to historical data |
Auth |
|---|---|---|---|
AEMET |
🇪🇸 Spain |
🕐 Latest 24h only |
🔑 API key (free) |
Agrometeo |
🇨🇭 Switzerland |
✅ Yes |
✅ None |
ASOS 1-min (IEM) |
🇺🇸 USA |
✅ Yes |
✅ None |
ASOS/METAR (IEM) |
🌍 Global |
✅ Yes |
✅ None |
AWEL |
🇨🇭 Zurich |
✅ Yes |
✅ None |
GHCNh (NOAA) |
🌍 Global |
✅ Yes |
✅ None |
Meteocat |
Catalonia |
✅ Yes |
🔑 API key (free) |
MeteoSwiss |
🇨🇭 Switzerland |
✅ Yes |
✅ None |
Netatmo |
🌍 Global |
✅ Yes |
🔑 API key (free) |
See more details about how to use each provider in the respective sections below as well as in the API documentation.
AEMET#
AEMET is the meteorological agency of the Spanish state. It provides a REST API to access its data. To use the AEMET API, you first need to have an API key. You can get one by registering at opendata.aemet.es/centrodedescargas/obtencionAPIKey.
AWEL#
The Office of Waste, Water, Energy and Air (AWEL) of the canton of Zurich (Switzerland) operates a network of 50 sensors that measure air temperature and humidity. The measured values are freely available as open data (link in German).
Agrometeo#
Agrometeo is a Swiss meteorological service that provides weather data for agriculture, which can be accessed for free and without authentication.
Global Historical Climatology Network hourly (GHCNh)#
The Global Historical Climatology Network hourly (GHCNh) is a dataset of hourly surface weather observations from fixed, land-based stations from numerous sources around the world. The GHCNh is managed by the National Oceanic and Atmospheric Administration (NOAA) and can be accessed for free and without authentication. Note that the same dataset is also provided at the daily and monthly resolutions, however Meteora currently only supports the hourly dataset (since daily and monthly aggregations can be easily computed from the hourly records).
Iowa Environmental Mesonet (IEM)#
The Iowa Environmental Mesonet (IEM) provides access to a wide range of environmental data, including weather observations from the Automated Surface Observing System (ASOS) stations in the United States. The IEM provides two clients to access ASOS data: one for 1-minute data and another for METAR data. Both clients can be accessed without authentication.
Meteocat#
Meteocat is the Catalan Meteorological Service. It provides a REST API to access its data. To use the Meteocat API, you first need to have an API key. You can get one by registering at apidocs.meteocat.gencat.cat/section/informacio-general/plans-i-registre. You can choose the “Accés ciutadà i administració” plan, which is free, or the paid “Accés professionals” plan. In both cases, you need to check the box “Dades de la XEMA” (automated weather stations) to get access to the data used in Meteora. You will then receive by mail the API key.
MeteoSwiss#
MeteoSwiss is the Federal Office of Meteorology and Climatology of Switzerland. Since May 2025, “MeteoSwiss is gradually making its data accessible as Open Government Data” which can be downloaded using a REST API. Meteora provides a client to retrieve the data from the 160 stations of the SwissMetNet automatic measurement networw, which delivers data on temperature, precipitation, wind, sunshine, humidity, radiation and pressure every 10 minutes.
Netatmo#
Netatmo is a manufacturer of smart home devices including citizen weather stations (CWS). Their Weather API permits retrieving the measurements of users who share it publicly, including temperature, humidity, pressure, wind and precipitation. In order to access the data from Netatmo CWS, you need a client ID and client secret, which can be obtained following the steps below:
If you do not have a Netatmo account, sign up at auth.netatmo.com/access/signup.
If you do not have any app, you can create one from your account by navigating to dev.netatmo.com/apps and clicking “Create”. As far as Meteora is concerned, this only serves to obtain a client ID and secret key, so you do not need to enter any specific information in “app name” and “description”.
Once the app is created, save the generated “client ID” and “client secret” which will appear in the form below (entitled “App Technical Parameters”). You will need to provide them for the initialization of meteora.clients.NetatmoClient.