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.

The cost of 1 location is 45 USD.
To buy or learn more, please get in touch with us at info@openweathermap.org and attach a list of locations to your letter.
Please note that we do provide discounts for enquiries with extensive amount of locations.

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.
Historical Forecasts 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}

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,
     ...