History Forecast Bulk

This service allows to extract historical forecast weather data from October 7, 2017 for any location. Find more about historical data availability on the pricing page.

About History Forecast Bulk

History Forecast Bulk provides an archive of previous forecasts starting from October 7, 2017.

By using this service, you can receive data on previously made 16-day forecasts for any coordinates on the globe.

There are two formats this can be provided in: CSV and JSON.

The examples of data can be found in the "Sample data" section.

Please contact us when requesting data for a large number of locations. We’ll prepare and export the data for you.

Buy History Forecast Bulk

Structure of the product

Historical forecast data is available from 7 October 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 data are included, please click 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 7 October 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. Go to the OpenWeatherMap Marketplace and choose "New History Forecast Bulk" product.
  2. Select locations. There are 4 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 location name. Click on the search line, input location name and choose it 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. Click on the search line, choose "By coordinate" option, enter latitude and longitude to the form and push the "Enter" button on your keyboard. The chosen location will be displayed on the map, click on the "Add location" tab to add this location into your order.
    • Import coordinates via CSV file. Click on the search line, choose "Import" option and follow the detail instruction on the form to download your CSV file with a list of coordinations.
  3. Weather parameters, measurement units and the format of the downloadable output file can be also configurable per your preferences.
  4. Click on the "Confirm order" button and check your oreder details.
  5. To complete the checkout process, please click on the "Checkout" button and proceed to payment.
Buy History Forecast Bulk

After the successful payment you will be able to find your order in two ways:

  1. You will also receive a letter to your email with the link to download your current order.
  2. All purchases can be found in your personal account, in the "Order" section.
Extract example

Sample data

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

JSON
CSV

Fields in History Forecast Bulk

JSON format

  • 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
    • main.dew_point Temperature of the dew point
    • 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
    • wind.deg Wind direction, degrees (meteorological)
  • clouds
    • clouds.all Cloudiness, %
  • dt Date for which the forecast is made, unix, UTC

CSV format

  • forecast dt unixtime Forecast calculation time in unix timestamp
  • forecast dt iso Forecast calculation time in ISO format
  • slice dt unixtime Time for which the corresponding forecast part was calculated in unix timestamp
  • slice dt iso Time for which the corresponding forecast part was calculated in ISO format
  • lat Latitude
  • lon Longitude
  • temperature Temperature
  • dew_point Temperature of the dew point
  • pressure Atmospheric pressure (on the sea level), hPa
  • ground_pressure Atmospheric pressure (on the surface), hPa
  • humidity Humidity, %
  • clouds
  • wind_speed Wind speed
  • wind_deg Wind direction, degrees (meteorological)
  • rain Rain, mm
  • snow Snow water equivalent, mm
  • ice Ice pellets, mm
  • fr_rain Freezing rain volume, mm
  • convective Convective precipitation, mm
  • snow_depth Depth of snow, cm
  • accumulated Accumulated volume of precipitation, mm
  • hours Number of hours for which precipitation values are calculated
  • rate Precipitation intensity, mm/s
  • probability Probability of precipitation

    • Example of History Forecast Bulk

    JSON example

    Please find below an example of data in JSON format for one measurement

    History Forecast Bulk example 
                         

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

    CSV example

    Please find below an example of data in CSV format for one measurement