History Bulk

This product allows you to extract historical data for a chosen city. 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. This data is available for any period of time within last 7 years (from October 01, 2012 till now).

To get historical weather data for 40 years please contact us at [email protected].

Data is provided with hourly step.

There are two formats this can be provided in: CSV and JSON.
Please click here to download examples.


How to get historical weather data

To request History 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 "History bulk" tab and, after that, choose "New History bulk" option on the left-hand side.
  3. Specify requirement locations, period of time, file format and other weather parameters.
  4. Click on the "Checkout" button and follow the PayPal instructions to complete the payment.
  5. 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 "Requests" section
    • You will also receive a letter to your email with the link to download your current order


The example of extraction process is below:

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