History Forecast Bulk

About History Forecast Bulk

History Forecast Bulk provides an archive of previous forecasts starting from April 6, 2017.
By using this service, you can receive data on previously made 16-day forecasts for any coordinates on the globe.
There are 2 ways to get History Forecast Bulk:

  1. Purchase via Personal account
    We provide the opportunity to purchase and download our weather data directly from your Personal account. Data are available for up to 2 years back (from April 6, 2017 till now) .
    Please read this page to know how to do it.
  2. Contact us at info@openweathermap.org
    If you plan to order historical data for an extensive number of locations, we recommend to contact us directly at info@openweathermap.org. Our experts will process your list of locations and export the necessary data for you from our archive.

Structure of the product

Historical forecast data is available from 6 April 2017.

A 16-day forecast is a set of values for weather parameters for each of the 16 days ahead.
There are 4 model recalculation cycles available for each day. Each time when recalculation happens, the new forecast is generated (it updates values of weather parameters in the forecast).
Forecasts are updated at these times: 00:00 UTC, 06:00 UTC, 12:00 UTC, 18:00 UTC.

To see what weather parameters are included, please see here.
History Forecast Bulk are available in CSV and JSON.

A 16-day forecast is a set of values for weather parameters that are available in 3-hour steps for 16 days ahead.

Thus, each day will have the following structure:

00:00 UTC  {forecast weather data for 1st day - 16th day}

06:00 UTC  {forecast weather data for 1st day - 16th day}

12:00 UTC  {forecast weather data for 1st day - 16th day}

18:00 UTC  {forecast weather data for 1st day - 16th day}

Please be aware that older historical forecasts will have different time steps.
Please see more below:

From 6 April 2017 to 15 June 2019, forecasted data in each recalculation cycle was available with the following steps:
{1st day - 10th day with 3-hour steps, 11th day - 16th day with 12-hour steps}

On 15th of June 2019 we have upgraded the service and forecast step became 3-hour for the whole period of the forecast:
{1st day - 16th day with 3-hour steps}

How to get History Forecast Bulk

To request History Forecast Bulk for your locations, please follow these steps:

  1. Sign up to the personal account. If you are already registered, please just Sign in.
  2. Go to the "Store" tab and, after that, click on the "Buy" button.
  3. Select locations. There are 3 ways to set your locations:
    • Click on the map. Click on the map and the pin will be set on the chosen location. Click on the "Add location" to add this location into your order or click on another place on the map.
    • Input the city name. Select "By city name" tab on the map, input the city name and choose a location from the dropdown list. The chosen location will be displayed on the map, click on the "Add location" tab to add this location into your order.
    • Input coordinates. Select "By coordinate" tab on the map, enter latitude and longitude to the form and click on the button on the right-hand side. The chosen location will be displayed on the map, click on the "Add location" tab to add this location into your order.
  4. Specify other required fields:
    • Period of time
    • Weather parameters Please select at least one weather parameter.
    • Units We provide 3 types of units for weather parameters.
    • File formats CSV or JSON.
  5. Click on the "Buy History Forecast Bulk" button and follow the PayPal instructions to complete the payment.
  6. After the successful payment you will be able to find your order in two ways:
    • All purchases can be found in your personal account, in the "Orders" section
    • You will also receive a letter to your email with the link to download your current order


BUY HISTORY FORECAST BULK

Sample data

There are two formats of files History Forecast bulk can be provided in. Please find the examples below:

JSON

CSV


Parameters in History Forecast Bulk

  • Time of the forecast recalculation cycle, unix, UTC
  • main
    • main.pressure Atmospheric pressure (on the sea level), hPa
    • main.grnd_pressure Atmospheric pressure (on the surface), hPa
    • main.temp Temperature. The temperature is provided only in Kelvins
    • main.dew_point Temperature of the dew point. The temperature is provided only in Kelvins
    • main.humidity Humidity, %
  • precipitation
    • precipitation.snow_depth Depth of snow, cm
    • precipitation.snow Snow water equivalent, mm
    • precipitation.rain Rain, mm
    • precipitation.hours Number of hours for which precipitation values are calculated
    • precipitation.rate Intensity, mm/s
    • precipitation.fr_rain Freezing rain, mm
    • precipitation.ice Ice pellets, mm
  • wind
    • wind.speed Wind speed. Unit Default: meter/sec
    • wind.deg Wind direction, degrees (meteorological)
  • clouds
    • clouds.all Cloudiness, %
  • dt Date for which the forecast is made, unix, UTC

Example of History Forecast Bulk

Please find below an example of response for one measurement


{
   "1568505600":[
      {
         "main":{
            "pressure":1011.382,
            "grnd_pressure":1011.34,
            "temp":298.8,
            "dew_point":296.995,
            "humidity":90
         },
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":1,
            "rate":0,
            "fr_rain":0,
            "ice":0
         },
         "wind":{
            "speed":6.271,
            "deg":176.123
         },
         "dt":1568505600
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.188,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.188,
            "accumulated":0.188,
            "ice":0
         },
         "main":{
            "pressure":1012.988,
            "grnd_pressure":1012.982,
            "temp":298.8,
            "dew_point":297,
            "humidity":89.9
         },
         "clouds":{
            "all":36
         },
         "wind":{
            "speed":5.806,
            "deg":173.562
         },
         "dt":1568516400
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.25,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.25,
            "accumulated":0.25,
            "ice":0
         },
         "main":{
            "pressure":1014.841,
            "grnd_pressure":1014.701,
            "temp":299.046,
            "dew_point":297.1,
            "humidity":89.2
         },
         "clouds":{
            "all":43
         },
         "wind":{
            "speed":6.272,
            "deg":166.125
         },
         "dt":1568527200
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.25,
            "accumulated":0,
            "ice":0
         },
         "main":{
            "pressure":1012.607,
            "grnd_pressure":1012.578,
            "temp":299.114,
            "dew_point":297.113,
            "humidity":88.6
         },
         "clouds":{
            "all":3
         },
         "wind":{
            "speed":6.123,
            "deg":172.049
         },
         "dt":1568538000
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.25,
            "accumulated":0.062,
            "ice":0
         },
         "main":{
            "pressure":1011.167,
            "grnd_pressure":1011.277,
            "temp":299.213,
            "dew_point":297.013,
            "humidity":87.5
         },
         "clouds":{
            "all":36
         },
         "wind":{
            "speed":5.698,
            "deg":166.139
         },
         "dt":1568548800
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.25,
            "accumulated":0,
            "ice":0
         },
         "main":{
            "pressure":1012.304,
            "grnd_pressure":1012.21,
            "temp":299.1,
            "dew_point":297.054,
            "humidity":88.7
         },
         "clouds":{
            "all":100
         },
         "wind":{
            "speed":5.881,
            "deg":172.732
         },
         "dt":1568559600
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.312,
            "accumulated":0.062,
            "ice":0
         },
         "main":{
            "pressure":1013.263,
            "grnd_pressure":1013.216,
            "temp":298.969,
            "dew_point":297,
            "humidity":89.1
         },
         "clouds":{
            "all":100
         },
         "wind":{
            "speed":6.721,
            "deg":180.179
         },
         "dt":1568570400
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.125,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.438,
            "accumulated":0.125,
            "ice":0
         },
         "main":{
            "pressure":1012.155,
            "grnd_pressure":1012.23,
            "temp":298.8,
            "dew_point":296.9,
            "humidity":89.3
         },
         "clouds":{
            "all":92
         },
         "wind":{
            "speed":7.404,
            "deg":182.895
         },
         "dt":1568581200
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.375,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.688,
            "accumulated":0.375,
            "ice":0
         },
         "main":{
            "pressure":1010.938,
            "grnd_pressure":1011.04,
            "temp":298.7,
            "dew_point":296.7,
            "humidity":88.8
         },
         "clouds":{
            "all":83
         },
         "wind":{
            "speed":6.88,
            "deg":183.625
         },
         "dt":1568592000
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.75,
            "accumulated":0.062,
            "ice":0
         },
         "main":{
            "pressure":1012.538,
            "grnd_pressure":1012.408,
            "temp":298.722,
            "dew_point":296.807,
            "humidity":88.9
         },
         "clouds":{
            "all":73
         },
         "wind":{
            "speed":6.664,
            "deg":188.326
         },
         "dt":1568602800
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.812,
            "accumulated":0.125,
            "ice":0
         },
         "main":{
            "pressure":1014.067,
            "grnd_pressure":1013.967,
            "temp":298.9,
            "dew_point":297,
            "humidity":89.2
         },
         "clouds":{
            "all":77
         },
         "wind":{
            "speed":5.908,
            "deg":182.221
         },
         "dt":1568613600
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.812,
            "accumulated":0,
            "ice":0
         },
         "main":{
            "pressure":1012.372,
            "grnd_pressure":1012.518,
            "temp":299.081,
            "dew_point":296.981,
            "humidity":88.1
         },
         "clouds":{
            "all":100
         },
         "wind":{
            "speed":5.186,
            "deg":185.344
         },
         "dt":1568624400
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":0.875,
            "accumulated":0.062,
            "ice":0
         },
         "main":{
            "pressure":1010.384,
            "grnd_pressure":1010.45,
            "temp":299.261,
            "dew_point":296.946,
            "humidity":87.1
         },
         "clouds":{
            "all":100
         },
         "wind":{
            "speed":5.712,
            "deg":186.918
         },
         "dt":1568635200
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.062,
            "hours":3,
            "rate":0,
            "fr_rain":0,
            "convective":0.938,
            "accumulated":0.062,
            "ice":0
         },
         "main":{
            "pressure":1011.462,
            "grnd_pressure":1011.523,
            "temp":299.139,
            "dew_point":297.104,
            "humidity":88.7
         },
         "clouds":{
            "all":67
         },
         "wind":{
            "speed":5.049,
            "deg":189.645
         },
         "dt":1568646000
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0,
            "hours":6,
            "rate":0,
            "fr_rain":0,
            "convective":1,
            "accumulated":0.125,
            "ice":0
         },
         "main":{
            "pressure":1012.276,
            "grnd_pressure":1012.219,
            "temp":298.854,
            "dew_point":297.2,
            "humidity":90.4
         },
         "clouds":{
            "all":61
         },
         "wind":{
            "speed":6.134,
            "deg":185.304
         },
         "dt":1568656800
      },
      {
         "precipitation":{
            "snow_depth":0,
            "snow":0,
            "rain":0.062,
            "hours":3,
     ...