---
metadata:
  - name: generator
    content: Diplodoc Platform v5.56.0
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/history.md
  - https://yandex.com/dev/weather/doc/ru/concepts/history.md
  - href: en/concepts/history.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/weather/doc/en/llms.txt

## Export of weather history {#history}

You can request hourly historical weather data for over **70 years deep** for any location. It includes [19 weather parameters](#parameters).

### Features of History Data {#features}

* You can select which [weather parameters](#parameters) you want to get: temperature, precipitation, wind and others.
* You can select your location on the map or input a location name in search.
* You can also configure units of measurement and output [file formats (CSV or JSON)](#examples).
* You can choose to get data from multiple locations in a single file or in an archive with separate files for each location.

{% note info %}

Please [contact us](mailto:b2b-weather@support.yandex.ru?subject=History+dataset) when requesting data for a large number of locations or large time ranges.

{% endnote %}

### Samples of archives {#examples}

[CSV](https://yastatic.net/weather/i/b2b/sample.csv)

[JSON](https://yastatic.net/weather/i/b2b/sample.json)

### Available parameters {#parameters}
<table>
	<thead>
		<tr>
			<th><b>Variable</b></th>
			<th><b>Interpretation</b></th>
			<th><b>Standard unit</b></th>
			<th><b>Metric unit</b></th>
			<th><b>Imperial unit</b></th>
		</tr>
	</thead>
	<tbody>
    	<tr>
			<td><code>temperature</code></td>
			<td>2m air temperature</td>
			<td>Kelvin</td>
			<td>Celsius</td>
			<td>Fahrenheit</td>
		</tr>
    	<tr>
			<td><code>dew_point</code></td>
			<td>2m dew point</td>
			<td>Kelvin</td>
			<td>Celsius</td>
			<td>Fahrenheit</td>
		</tr>
		<tr>
			<td><code>humidity</code></td>
			<td>relative humidity</td>
			<td>percent</td>
			<td>percent</td>
			<td>percent</td>
		</tr>
        <tr>
			<td><code>pressure</code></td>
			<td>Mean sea level pressure</td>
			<td>Hectopascals</td>
			<td>Hectopascals</td>
			<td>Hectopascals</td>
		</tr>
		<tr>
			<td><code>u_wind</code></td>
			<td>U-wind component on 10m</td>
			<td>Meters per second</td>
			<td>Meters per second</td>
			<td>Miles per hour</td>
		</tr>
        <tr>
			<td><code>v_wind</code></td>
			<td>V-wind component on 10m</td>
			<td>Meters per second</td>
			<td>Meters per second</td>
			<td>Miles per hour</td>
		</tr>
        <tr>
			<td><code>wind_gust</code></td>
			<td>10m wind gust</td>
			<td>Meters per second</td>
			<td>Meters per second</td>
			<td>Miles per hour</td>
		</tr>
		<tr>
			<td><code>cloud_height</code></td>
			<td>Cloud base height</td>
			<td>Meters</td>
			<td>Meters</td>
			<td>Feet</td>
		</tr>
        <tr>
			<td><code>cloud_cover</code></td>
			<td>Total cloud cover</td>
			<td colspan="3">Floating point number in range <code>[0, 1]</code>, where: <ul>
                <li><code>0</code> - clear sky</li>
                <li><code>1</code> - sky is completely covered with clouds</li>
            </ul></td>
		</tr>
		<tr>
			<td><code>precipitation_type</code></td>
			<td>Precipitation type at <code>time</code></td>
			<td colspan="3"><ul>
				<li><code>0</code> – No precipitation</li>
                <li><code>1</code> – Rain</li>
                <li><code>3</code> – Freezing rain (i.e. supercooled raindrops which freeze on contact with the ground and other surfaces)</li>
                <li><code>5</code> – Snow</li>
                <li><code>6</code> – Wet snow (i.e. snow particles which are starting to melt)</li>
                <li><code>7</code> – Mixture of rain and snow</li>
                <li><code>8</code> – Ice pellets</li>
            </ul></td>
		</tr>
        <tr>
			<td><code>hourly_precipitation</code></td>
			<td>Accumulated precipitation over the past hour</td>
			<td>Meters</td>
			<td>Millimeters</td>
			<td>Inches</td>
		</tr>
		<tr>
			<td><code>soil_temperature</code></td>
			<td>Soil temperature at 0-7 cm</td>
			<td>Kelvin</td>
			<td>Celsius</td>
			<td>Fahrenheit</td>
		</tr>
		<tr>
			<td><code>volumetric_soil_water</code></td>
			<td>Volumetric soil water at 0-7 cm</td>
			<td>cubic meter / cubic meter</td>
			<td>cubic meter / cubic meter</td>
			<td>cubic meter / cubic meter</td>
		</tr>
        <tr>
			<td><code>evaporation</code></td>
			<td>Evaporation</td>
			<td>Meters of water equivalent</td>
			<td>Meters of water equivalent</td>
			<td>Meters of water equivalent</td>
		</tr>
        <tr>
			<td><code>potential_evaporation</code></td>
			<td>Potential evaporation</td>
			<td>Meters of water equivalent</td>
			<td>Meters of water equivalent</td>
			<td>Meters of water equivalent</td>
		</tr>
        <tr>
			<td><code>mean_evaporation_rate</code></td>
			<td>Mean evaporation rate</td>
			<td>Kilograms per square meter per second</td>
			<td>Kilograms per square meter per second</td>
			<td>Kilograms per square meter per second</td>
		</tr>
        <tr>
			<td><code>mean_potential_evaporation_rate</code></td>
			<td>Mean potential evaporation rate</td>
			<td>Kilograms per square meter per second</td>
			<td>Kilograms per square meter per second</td>
			<td>Kilograms per square meter per second</td>
		</tr>
		<tr>
			<td><code>wind_speed</code></td>
			<td>Wind speed</td>
			<td>Meters per second</td>
			<td>Meters per second</td>
			<td>Miles per hour</td>
		</tr>
        <tr>
			<td><code>wind_angle</code></td>
			<td>Wind angle</td>
			<td>Degrees</td>
			<td>Degrees</td>
			<td>Degrees</td>
		</tr>
        <tr>
			<td><code>wind_direction</code></td>
			<td>Wind direction</td>
			<td colspan="3"><ul>
				<li><code>n</code> – North</li>
                <li><code>ne</code> – Northeast</li>
                <li><code>e</code> – East</li>
                <li><code>se</code> – Southeast</li>
                <li><code>s</code> – South</li>
                <li><code>sw</code> – Southwest</li>
                <li><code>w</code> – West</li>
                <li><code>nw</code> – Northwest</li>
            </ul></td>
		</tr>
	</tbody>
</table>