History Forecast Bulk

This service allows to extract historical forecast weather data from April 6, 2017 for any location.
Find more about historical data availability in the price-list.

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

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. Go to the "New History Forecast Bulk" form.
  2. 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.
  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.



After the successful payment you will be able to find your order in two ways:
  1. All purchases can be found in your personal account, in the "Order" section.
  2. You will also receive a letter to your email with the link to download your current order.

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