History Bulk

This product allows you to extract 40 years of historical data for ANY chosen location or coordinates. The price is highly competitive - only 10$ per location. You can find more about ways to access historical data from our price page.

About History Bulk

This product allows you to download an archive of historical weather data for ANY location for up to 40 years back (from January 1, 1979 till now). Weather data archive includes 15 weather parameters, such as temperature, precipitation, wind and many more. Data is provided with hourly step.


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.


How to get historical weather data

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

  1. Go to the OpenWeatherMap Marketplace and choose"History 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. Set the time period for the uploaded weather archive.
  4. Weather parameters, measurement units and the format of the downloadable output file can be also configurable per your preferences.
  5. Click on the "Place order" button and check your order details.
  6. 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. 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 Bulk can be provided in. Please find the examples below:

JSON

CSV



Weather parameters in History Bulk

If you do not see some of the parameters in your API response, it means that these weather phenomena just have not happened in the chosen time period at the chosen location. Only really measured or calculated data is displayed in API response.

List of all API parameters with units openweathermap.org/weather-data

Parameters:
  • city_id City ID
  • weather (more info Weather condition codes)
    • weather.id Weather condition id
    • weather.main Group of weather parameters (Rain, Snow, Extreme etc.)
    • weather.description Weather condition within the group
    • weather.icon Weather icon id
  • main
    • main.temp Temperature. The temperature is provided only in Kelvins
    • main.pressure Atmospheric pressure (on the sea level), hPa
    • main.humidity Humidity, %
    • main.temp_min Minimum temperature at the moment. This is deviation from temperature that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). The temperature is provided only in Kelvins.
    • main.temp_max Maximum temperature at the moment. This is deviation from temperature that is possible for large cities and megalopolises geographically expanded (use these parameter optionally). The temperature is provided only in Kelvins.
  • wind
    • wind.speed Wind speed. Unit Default: meter/sec
    • wind.deg Wind direction, degrees (meteorological)
  • clouds
    • clouds.all Cloudiness, %
  • rain
    • rain.3h Rain volume for the last 3 hours, mm
  • snow
    • snow.3h Snow volume for the last 3 hours, mm (in liquid state)
  • dt Time of data calculation, unix, UTC
  • dt_isoDate and time in UTC format

Example:

{"city_id": 5128581,
"main": {
    "temp": 271.9,
    "temp_min": 270.15,
    "temp_max": 274.15,
    "pressure": 1010,
    "humidity": 86},
"wind": {
    "speed": 2.1,
    "deg": 30},
"clouds": {"all": 90},
"weather": [{
    "id": 701,
    "main": "Mist",
    "description": "mist","icon": "50n"},
    {
    "id": 600,
    "main": "Snow",
    "description": "light snow","icon": "13n"}],
"dt": 1485907200,
"dt_iso": "2017-02-01 00:00:00 +0000 UTC"}



List of weather condition codes

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere including extreme conditions like tornado, hurricane etc.)