About OpenWeatherMap

OpenWeatherMap service provides current weather data, forecasts and historical data (starting from 1979) to more than 2 million customers, including Fortune 500 companies and thousands of other businesses globally.
More than 20 weather APIs have been developed for getting different types of weather data. They support multiple languages, units of measurement and data formats.
As well as receiving weather data, users can also connect their weather stations to provide such data to OpenWeatherMap. This is intended to help improve the quality of weather data for these locations, especially those that are far from major cities.
Additionally, the OpenWeatherMap service allows any users to get basic weather data on the website.


Current and forecast collection

The OpenWeatherMap service provides a Current Weather API, along with several types of forecasts with different depths and measurement steps:

Historical collection

The new technology called Time Machine was launched in 2019, allowing enhancement of historical weather data. Time Machine is an algorithm that allows over 40 years’ worth of hourly historical data to be obtained for any given coordinates. Based on this technology, this collection includes several types of historical weather data and several options for getting it.

Historical weather data

  • History Bulk – one-time data export
    This product allows the user to receive hourly historical data in the form of a CSV or JSON file. The archive data goes back to the start of January 1979. It can be customised: the user can choose from 15 weather parameters, and can select their preferred units and data formats. A single History Bulk file can contain historical data for one or more locations.

  • History API – requires monthly subscription to an API
    This service provides API access to hourly historical data. A subscriber can request data for any coordinates. The data is city-based: if the user specifies certain coordinates in their API call, data from the closest available city that exists in the database will be provided. The depth of available data is one month, one year or multiple years, depending on the subscription.

Statistical weather data

    The Statistical Weather Data API (requiring a monthly subscription) provides statistical data for the main weather parameters, aggregated in various ways: for a specific date or month, or the whole year.
    This format of historical data enables new ways of analysing climatic indicators, and provides a basis for a statistical approach to weather forecasting. It is available in the JSON data format.

Historical forecast weather data

    History Forecast Bulk (a one-time data export) allows the user to get a previously made 16-day forecast from the archive, starting from 6 April 2017. Data is available for any town or city. Files are available in the CSV and JSON formats.

Weather maps collection

The weather maps collection contains the Weather Maps and Relief Maps services. These products allow developers to add weather and relief maps to their applications using URL requests.

    Weather Maps

      The Weather Maps service supports current weather maps, forecast weather maps for 10 days, and historical weather maps for any day and time since 9 February 2018. To get these, the user needs to change a single parameter in the URL request.
      The Weather Maps service has a range of weather layers including precipitation, clouds, pressure, temperature, wind, and many more.

    Relief Maps

      The Relief Maps service allows the user to set the position of the light source and adjust the transparency of the colour layer. This allows developers to use these settings as a base layer for weather maps.

Others: Weather Alerts, UV Index, Air Pollution

    Weather Alerts

      The Weather Triggers API allows developers to set trigger conditions, and allows end-users to monitor trigger execution in real time. It can be customised for an end-user request.
      The Weather Triggers API supports the same weather conditions as the weather APIs do: wind speed, temperature, humidity, etc. The API syntax is quite simple and consists of a few methods. The required parameters are time period and location. Nevertheless, the querying of trigger execution and their further interpretation should be carried out by the end-user.

    UV Index

      The UV Index API gives users access to current, forecast and historical UV data for any location on Earth, including over 200,000 towns and cities. It makes data available in the JSON format.

    Air Pollution

      The Air Pollution API provides current and historical (since November 2015) data on air pollution, with CO, O3, NO2 and SO2 as the main indexes, in the JSON format.

Weather APIs for developers

Simple and fast APIs. Access to current weather, forecasts, maps and historical data in JSON, XML, and HTML formats. A variety of map layers are available including precipitation, clouds, pressure, temperature, wind, and many more.

Connect your weather station to OpenWeatherMap

We are glad to invite you to join our network of private weather stations. Today we have more than 40,000 weather stations around the world. You can connect your weather station to OpenWeatherMap and get a convenient interface for gathering and monitoring data from your weather station. You can also embed your weather station data into your home page.