---
metadata:
  - name: generator
    content: Diplodoc Platform v5.56.0
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/releases.md
  - https://yandex.com/dev/weather/doc/ru/concepts/releases.md
  - href: en/concepts/releases.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

# History of changes to the API

The current version of the Yandex Weather API is v2 and v3.

**Address for sending requests to v2:**

`https://api.weather.yandex.ru/v2`

**Address for sending requests to v3:**

`https://api.weather.yandex.ru/graphql/query`

#### November 2019

New API version (v2).

Possible values changed for the following response fields:
- [fact.condition](https://yandex.com/dev/weather/doc/en/concepts/forecast-info.md#fact) and [forecast.condition](https://yandex.com/dev/weather/doc/en/concepts/forecast-info.md#forecasts) for the “Yandex Weather on your site” and “Test” rates.
- [forecast.moon_text](https://yandex.com/dev/weather/doc/en/concepts/forecast-info.md#moon-code) for the “Yandex Weather on your site” and “Test” rates.
- [fact.prec_type](forecast-test#fact) and [forecast.prec_type](forecast-test#forecast) for the “Test” rate.

#### February 2024

New API version (v3).

The interaction protocol has been completely redesigned and replaced from REST to Graphql.

Added:
* New parameters (full list of parameters is available by [link](https://yandex.com/dev/weather/doc/en/concepts/parameters.md)): 
    * [aqi](*aqi), [iaqi](*iaqi), [dominant](*dominant) (Air quality indices);
    * [co](*co), [density](*density),  [no2](*no2), [o3](*o3), [pm10](*pm10), [pm2p5](*pm2p5), [so2](*so2) (concentration of pollutants in the atmosphere);
    * [dewPoint](*dewPoint), [leafWetnessIndex](*leafWetnessIndex) (parameters of the dew point);
    * [dustStormStrength](*dustStormStrength) (risk of dust storm);
    * [imfBt](*imfBt), [imfBx](*imfBx), [imfBy](*imfBy), [imfBz](*imfBz) (characteristics of the interplanetary magnetic field);
    * [oceanTide](*oceanTide), [seaCurrentAngle](*seaCurrentAngle), [seaCurrentSpeed](*seaCurrentSpeed), [waveHeight](*waveHeight), [wavePeriod](*wavePeriod) (ocean and sea parameters);
    * [solarIrradiation](*solarIrradiation), [solarWindDensity](*solarWindDensity), [solarWindSpeed](*solarWindSpeed) (characteristics of solar radiation and wind);
    * [cloudinessOnHeight](*cloudinessOnHeight), [temperatureOnHeight](*temperatureOnHeight), [windAngleOnHeight](*windAngleOnHeight), [windSpeedOnHeight](*windSpeedOnHeight) (parameters at various heights);
    * [referenceEvapotranspiration](*referenceEvapotranspiration) (evaporated moisture);
* [Raw observations of meteorological stations](https://yandex.com/dev/weather/doc/en/concepts/stations.md) and [archive](https://yandex.com/dev/weather/doc/en/concepts/stations.md#station-by-period);
* Historical data of forecasts for the week into the past;

[Actual documentation](https://yandex.com/dev/weather/doc/en/concepts/index-v3.md)

[*aqi]:
 
Air quality index (AQI).
See more here <a href="https://www.airnow.gov/aqi/aqi-basics/">www.airnow.gov/aqi/aqi-basics/</a>
 
**Possible values:** `[0, 500]`

[*iaqi]:
 
The individual AQI for a specific pollutant.
See more here <a href="https://www.airnow.gov/aqi/aqi-basics/">www.airnow.gov/aqi/aqi-basics/</a>
 
You can request multiple values of this field, using following syntax:
 
`coIAQI: iaqi(pollutant: CO)`
 
**Possible values:** `[0, 500]`

[*dominant]:
 
The pollutant that makes the greatest contribution to the calculation of AQI.
You can assume that `aqi` is the IAQI of this pollutant.
See more here <a href="https://www.airnow.gov/aqi/aqi-basics/">www.airnow.gov/aqi/aqi-basics/</a>
 
**Possible values:** [Pollutant](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Pollutant)

[*co]:
 
Carbon monoxide (CO) is a colorless, highly poisonous, odorless,
tasteless, flammable gas that is slightly less dense than air.
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*density]:
 
The density of air or atmospheric density,
is the mass per unit volume of Earth's atmosphere.
 
**Units:** `kg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*no2]:
 
The major sources of anthropogenic emissions of NO2 are
combustion processes (heating, power generation, and engines in vehicles and ships).
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*o3]:
 
Ground-level ozone (O3), also known as surface-level ozone and
tropospheric ozone, is a trace gas in the troposphere.
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*pm10]:
 
PM10 is a suspended large solid particles,
with a diameter of 10 micrometers (microns) or less.
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*pm2p5]:
 
PM2.5 is a fine particulate matter,
with a diameter of 2.5 micrometers (microns) or less.
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*so2]:
 
SO2 is a colorless gas with a pungent odor,
which is formed during the burning of fossil fuels
and the melting of mineral ores containing sulfur.
See more here <a href="https://www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health">www.who.int/news-room/fact-sheets/detail/ambient-(outdoor)-air-quality-and-health</a>
 
**Units:** `µg⋅m⁻³`
**Possible values:** `[0, +Infinity)`

[*dewPoint]:
 
The dew point value in the shade
at a height of 2 meters from the ground surface.
 
**Possible values:** [TemperatureUnit](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-TemperatureUnit)

[*leafWetnessIndex]:
 
Indicates whether there is moisture on leaves (`true`) or not (`false`).
This value is calculated based on factors such as precipitation,
air temperature, surface temperature, and dew point.
 
**Possible values:** [Boolean](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Boolean)

[*dustStormStrength]:
 
Strength of a duststorm. Based on wind speed and
amount of dust particles in the atmosphere.
 
**Possible values:** [DustStormStrength](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-DustStormStrength)

[*imfBt]:
 
Interplanetary Magnetic Field in nT. Bt - the total strength of the IMF. More information: <a href="https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html">www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*imfBx]:
 
Interplanetary Magnetic Field in nT. Bx axis. More information: <a href="https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html">www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*imfBy]:
 
Interplanetary Magnetic Field in nT. By axis. More information: <a href="https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html">www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*imfBz]:
 
Interplanetary Magnetic Field in nT. Bz axis. More information: <a href="https://www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html">www.spaceweatherlive.com/en/help/the-interplanetary-magnetic-field-imf.html</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*oceanTide]:
 
The height of the ocean water level relative to the specified datum in centimeters.
 
**Units:** `cm`
**Possible values:** `(-Infinity, +Infinity)`

[*seaCurrentAngle]:
 
Sea current angle from.
 
**Units:** `degrees`
**Possible values:** `[0, 360)`

[*seaCurrentSpeed]:
 
Sea current speed.
 
**Units:** `cm/s`
**Possible values:** `[0, +Infinity)`

[*waveHeight]:
 
Significant height of combined wind waves and swell surface.
 
**Units:** `m`
**Possible values:** `[0, +Infinity)`

[*wavePeriod]:
 
Primary wave mean period surface.
 
**Units:** `s`
**Possible values:** `[0, +Infinity)`

[*solarIrradiation]:
 
Average direct solar irradiation on the horizontal plane
<a href="https://en.wikipedia.org/wiki/Solar_irradiance">en.wikipedia.org/wiki/Solar_irradiance</a>
 
**Possible values:** [SolarIrradiationUnit](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-SolarIrradiationUnit)

[*solarWindDensity]:
 
Solar wind density in p/cm3. More information: <a href="https://www.swpc.noaa.gov/phenomena/solar-wind">www.swpc.noaa.gov/phenomena/solar-wind</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*solarWindSpeed]:
 
Solar wind speed in km/sec. More information: <a href="https://www.swpc.noaa.gov/phenomena/solar-wind">www.swpc.noaa.gov/phenomena/solar-wind</a>
 
**Possible values:** [Float](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-Float)

[*referenceEvapotranspiration]:
 
Preceding 1h or 3h evaporative water flux sum.
 
**Units:** `mm/h`
**Possible values:** `[0, +Infinity)`

[*cloudinessOnHeight]:
 
Cloud cover [%] at the closest to the given height (in meters). Use `height: 0` if you need total cloud cover.
 
**Possible values:** [CloudinessWithHeight](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-CloudinessWithHeight)

[*temperatureOnHeight]:
 
The temperature value in the closest to this height (in meters) above the surface of the earth.
 
**Possible values:** [TemperatureUnit](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-TemperatureUnit)

[*windAngleOnHeight]:
 
The angle of the wind direction in degrees in the closest to this height (in meters) above the surface of the earth.
 
**Possible values:** [WindAngleWithHeight](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-WindAngleWithHeight)

[*windSpeedOnHeight]:
 
The speed of wind in this height (in meters) above the surface of the earth.
 
**Possible values:** [WindSpeedUnit](https://yandex.com/dev/weather/doc/en/concepts/spectaql.md#definition-WindSpeedUnit)