## History Bulk This product enables you to extract hourly historical weather data for over **47+ years deep** for any chosen location or coordinate. It includes 15 weather [parameters](/history-bulk.md#parameter). You can find more info on how to access the historical data on our [pricing page](/price.md#history). - [Buy History Bulk](https://home.openweathermap.org/history_bulks/new) ## Features of History Bulk 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](/history-bulk.md#parameter). You can also select which weather parameters you want to get. 3. You can set up your location in 4 different ways: 4. - Choose a location on the map - Input a location name - Input coordinates - Import a list of coordinates via CSV file 5. The measurement units and the output file format (CSV or JSON) can be configured in accordance to your preferences. 6. You can choose to obtain the data for multiple locations in one file or in an archive with separate files for each location. - [Buy History Bulk](https://home.openweathermap.org/history_bulks/new) The examples of data can be found in the ["Sample data"](/history-bulk.md#examples) section. > Please [contact us](mailto:info@openweathermap.org) when requesting data for a large number of locations. We’ll be happy to 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](https://home.openweathermap.org/marketplace) and choose["History Bulk"](https://home.openweathermap.org/history_bulks/new) product. 2. Select locations. There are 4 ways to set your locations: 3. - **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. 4. Set the time period for the uploaded weather archive. 5. Configure list of weather parameters, measurement units and the format of the downloadable output file per your preferences. 6. Click on the "Place order" button and check your order details. 7. To complete the checkout process, please click on the "Checkout" button and proceed to payment. - [Buy History Bulk](https://home.openweathermap.org/history_bulks/new) 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"](https://home.openweathermap.org/history_bulks) section. ![history bulk](/payload/api/media/file/history_bulk.jpg) > Please see the following tips if you have any troubles to open weather archives of your orders: > > - If you are using the Windows operating system, please use 7zip or WinRAR to unpack the archive. > - In case you are using a Linux family operating system, the archive should be opened by standard means. ## Sample data There are two formats of files History Bulk can be provided in. Please find the examples below: [JSON](https://) [CSV](https://) ## Weather fields in History Bulk > If you do not see some of the parameters in your bulk, 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 your bulk. ### Parameters - `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-conditions.md)) - - `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](/history-bulk.md#list) - `weather.icon` Weather [icon id](/history-bulk.md#list) - `visibility` Average visibility, metres. The maximum value of the visibility is 10km - `dt` Time of data calculation, unix, UTC - `dt_iso`Date and time in UTC format - `timezone` Shift in seconds from UTC ## Example ### JSON Example ```json [{ "city_name":"Custom location", "lat":51.485927, "lon":0.24995, "main":{ "temp":277.72, "temp_min":275.632, "temp_max":279.15, "feels_like":273.99, "pressure":1029, "humidity":75, "dew_point" : 280.33 }, "wind":{ "speed":2.6, "deg":10, "gust": 5.8 }, "rain":{ "3h":1 }, "clouds":{ "all":75 }, "weather":[{ "id":500, "main":"Rain", "description":"light rain", "icon":"10n" }], "visibility":10000, "dt":1585612800, "dt_iso":"2020-03-31 00:00:00 +0000 UTC", "timezone":3600 }, ``` > We provide a broad variety of products such as [One Call API 4.0](/api/one-call-4.md), [Solar Irradiance & Energy Prediction service,](/products/solar-energy-prediction.md) [Road Risk API,](/api/road-risk.md) [Road Risk API,](/api/road-risk.md) [Air Pollution API](/api/air-pollution.md). Please review our [product list](/api.md) page and find more info in the product documentation and [pricing](/price.md) pages. ## List of weather condition codes List of [weather condition codes](/weather-conditions.md) with icons (range of thunderstorm, drizzle, rain, snow, clouds, atmosphere etc.)