Documentation

This product enables you to extract hourly historical weather data for over47+ years deep for any chosen location or coordinate. It includes 15 weather parameters.

You can find more info on how to access the historical data on our pricing page.

1. Historical weather data available from 1st January 1979 with 1-hour step.
2. The weather data archive that includes 15 weather parameters such as temperature, feels like, precipitation, wind and many more. You can also select which weather parameters you want to get.
3. You can set up your location in 4 different ways:
• Choose a location on the map
• Input a location name
• Input coordinates
• Import a list of coordinates via CSV file
4. The measurement units and the output file format (CSV or JSON) can be configured in accordance to your preferences.
5. You can choose to obtain the data for multiple locations in one file or in an archive with separate files for each location.

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

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 a 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 a list of 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. Configure list of weather parameters, measurement units and the format of the downloadable output file 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 receive a letter to your email with the link to download your current order.
2. All purchases can be also found in your personal account, in the "Order" section.

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

JSON

CSV

• city_name City name
• lat Geographical coordinates of the location (latitude)
• lon Geographical coordinates of the location (longitude)
• main
• main.temp Temperature
• 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).
• 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).
• main.feels_like This temperature parameter accounts for the human perception of weather
• main.pressure Atmospheric pressure (on the sea level), hPa
• main.humidity Humidity, %
• main.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form. Units – default: kelvin
• wind
• wind.speed Wind speed. Units – default: meter/sec
• wind.deg Wind direction, degrees (meteorological)
• wind.gust Wind gust. Units – default: meter/sec
• clouds
• clouds.all Cloudiness, %
• rain
• rain.1h Rain volume for the last hour, mm
• rain.3h Rain volume for the last 3 hours, mm
• snow
• snow.1h Snow volume for the last hour, mm (in liquid state)
• snow.3h Snow volume for the last 3 hours, mm (in liquid state)
• 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. Please find more here
• weather.icon Weather icon id
• visibility Average visibility, metres. The maximum value of the visibility is 10km
• dt Time of data calculation, unix, UTC
• dt_isoDate and time in UTC format
• timezone Shift in seconds from UTC

List of weather condition codes with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)