## Solar Irradiance History Bulk ### Product concept Solar Irradiance History Bulk allows you to retrieve an archive of historical solar radiation data for selected locations in a convenient, downloadable format. - Data archive available for 47+ years (from January 1, 1979) - Includes Global Horizontal Irradiation (GHI), Direct Normal Irradiation (DNI), and Diffuse Horizontal Irradiation (DHI) - Time intervals: 15-minute and 1-hour - Output formats: JSON and CSV Solar data is generated using advanced meteorological models. More details about the underlying technology are available in the [Solar Irradiance technology section](/api/solar-radiation/behind-solar-radiation-api.md). - [Buy Solar Irradiance History Bulk](https://home.openweathermap.org/solar_irradiance_history_bulks/new) > Please contact us when requesting data for a large number of locations. We’ll be happy to prepare and export the data for you. ## How to get Solar Irradiance History Bulk To request History Bulk for your locations, please follow these steps: 1. Go to the OpenWeatherMap Marketplace and choose the ["Solar Irradiance History Bulk"](https://home.openweathermap.org/solar_irradiance_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 detailed instruction on the form to download your CSV file with a list of coordinations. 4. Set the time period for the uploaded solar irradiance archive. 5. Configure list of solar irradiance indexes, time interval 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 Solar Irradiance History Bulk](https://home.openweathermap.org/solar_irradiance_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/marketplace/my_orders) section. ## Fields in Solar Irradiance History Bulk The output includes location metadata, timestamps, and solar radiation parameters. [JSON](#json_example) and [CSV](#csv_example) formats contain the same fields. ### Parameter definitions - `dt` Date corresponding to the start of the time interval for which energy is summed up, Unix, UTC - `dt_iso` Date corresponding to the start of the time interval for which energy is summed up, ISO format - `timezone` Shift in seconds from UTC - `lat` Latitude of the location,decimal (−90; 90) - `lon` Longitude of the location,decimal (-180; 180) - `ghi_cloudy_sky` - [Global Horizontal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `dni_cloudy_sky` - [Direct Normal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `dhi_cloudy_sky` - [Diffuse Horizontal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `ghi_clear_sky` - [Global Horizontal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `dni_clear_sky` - [Direct Normal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `dhi_clear_sky` - [Diffuse Horizontal Irradiation](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Energy (Wh/m²) - `ghi_cloudy_sky_avg` - [Global Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `dni_cloudy_sky_avg` - [Direct Normal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `dhi_cloudy_sky_avg` - [Diffuse Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `ghi_clear_sky_avg` - [Global Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `dni_clear_sky_avg` - [Direct Normal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `dhi_clear_sky_avg` - [Diffuse Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Avg power (W/m²) - `ghi_cloudy_sky_max` - [Global Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) - `dni_cloudy_sky_max` - [Direct Normal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) - `dhi_cloudy_sky_max` - [Diffuse Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) - `ghi_clear_sky_max` - [Global Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) - `dni_clear_sky_max` - [Direct Normal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) - `dhi_clear_sky_max` - [Diffuse Horizontal Irradiance](https://openweathermap.org/api/solar-radiation/behind-solar-radiation-api#introduction). Max power (W/m²) > For Solar Irradiance bulk we can provide you with a customized set and fields order in the API response. Please [contact us](mailto:info@openweathermap.org) via email and specify your needs. ## Sample data and example Here you can find and download example of Solar Irradiance History bulk file in [JSON](#json_example) and [CSV](#csv_example) format. ### JSON sample and example You can download sample of files History Forecast bulk in JSON format using link below: [JSON](https://) Please find below an example an example of data in JSON format for one measurement. ### CSV sample and example You can download sample of files History Forecast bulk in CSV format using link below: [CSV](https://) Please find below an example of data in CSV format in tabular format.