---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.6
alternate:
  - https://yandex.com/dev/weather/doc/en/concepts/forecast-test-v1.md
  - https://yandex.com/dev/weather/doc/ru/concepts/forecast-test-v1.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/weather/doc/en/llms.txt

# “Test” rate

{% note alert %}

This version of the API is deprecated. Use the [new version](https://yandex.com/dev/weather/doc/en/concepts/forecast-rest.md).

{% endnote %}

Use this request to get the current weather and forecast for the specified locality.

- [Request format](#req-format)
- [Response format](#resp-format)
- [Example](#req-example)

## Request format {#req-format}

The locality is indicated using the latitude ([lat](#lat-param) parameter) and longitude ([lon](#lon-param) parameter). If these parameters are set incorrectly, the response will contain a 404 error code.

```
GET https://api.weather.yandex.ru/v1/forecast?
 [lat](*lat)=<latitude>
 & [lon](*lon)=<longitude>
 & [[lang](*lang)=<response language>]
 & [[limit](*limit)=<forecast period>]
 & [[hours](*hours)=<hourly forecast>]
 & [[extra](*extra)=<detailed precipitation forecast>]

[X-Yandex-Weather-Key](*X_Yandex_Weather_Key): <key value>
```

Request headers:

#### X-Yandex-Weather-Key {#X-Yandex-Weather-Key-param}

The key you received when [enabling the Yandex Weather API](https://yandex.com/dev/weather/doc/en/concepts/api.md#onboarding).

Request parameters:

#### lat {#lat-param}

The latitude in degrees. Required field.

#### lon {#lon-param}

The longitude in degrees. Required field.

#### lang {#lang-param}

The combination of language and country that weather information will be returned for. Possible values:

- “ru_RU” — Russian for the Russia locale.
- “be_BY” — Belarusian for the Belarus locale.
- “kk_KZ” — Kazakh for the Kazakhstan locale.
- “tr_TR” — Turkish for the Turkey locale.
- “en_US” — International English.

#### limit {#limit-param}

The number of days in the forecast, including the current day.

For the “[Test](https://yandex.com/dev/weather/doc/en/concepts/pricing.md#test)” rate, the maximum value is 7.

#### hours {#hours-param}

For each day, the response will contain the hourly weather forecast. Possible values:

- “true” — Default value. Returns the hourly forecast.
- “false” — Does not return the hourly forecast.

#### extra {#extra-param}

Extra information about precipitation. Possible values:

- <true> — Returns detailed information about precipitation.
- <false> — Default value. Does not return detailed information about precipitation.

## Response format {#resp-format}

The response to the request is returned in JSON format. The information in the response contains:

#|
|| **Field** | **Description** | **Format** ||
|| `now` | The time on the server in Unix time. | Number ||
|| `now_dt` | The time on the server in UTC. | String ||
|| `info` | [Locality information object](#info). | Object ||
|| `fact` | [Current weather information object](#fact). | Object ||
|| `forecasts` | [Weather forecast object](#forecasts). | Object ||
|#

### info object {#info}

This object contains information about the locality.

#|
|| **Field** | **Description** | **Format** ||
|| `lat` | The latitude (in degrees). | Number ||
|| `lon` | The longitude (in degrees). | Number ||
|| `tzinfo` | Information about the time zone. Contains the fields [offset](*offset), [name](*name), [abbr](*abbr) and [dst](*dst). | Object ||
|| `offset` | Time zone in seconds from UTC. | Number ||
|| `name` | Name of the time zone. | String ||
|| `abbr` | Abbreviated name of the time zone. | String ||
|| `dst` | Daylight saving time. | Boolean ||
|| `def_pressure_mm` | The normal pressure for the given coordinates (mm Hg). | Number ||
|| `def_pressure_pa` | The normal pressure for the given coordinates (hPa). | Number ||
|| `url` | Locality page on [Yandex Weather](https://yandex.ru/pogoda/). | String ||
|#

### fact object {#fact}

This object contains information about the current weather.

#|
|| **Field** | **Description** | **Format** ||
|| `temp` | Temperature (°C). | Number ||
|| `feels_like` | What the temperature feels like (°C). | Number ||
|| `temp_water` | The water temperature (°C). This parameter is returned for localities where this information is relevant. | Number ||
|| `icon` | The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/\<value from the icon field\>.svg. | String ||
|| `condition` | The code for the weather description. Possible values:
- `clear` — Clear.
- `partly-cloudy` — Partly cloudy.
- `cloudy` — Cloudy.
- `overcast` — Overcast.
- `partly-cloudy-and-light-rain` — Partly cloudy, light rain.
- `partly-cloudy-and-rain` — Partly cloudy, rain.
- `overcast-and-rain` — Overcast, heavy rain.
- `overcast-thunderstorms-with-rain` — Heavy rain, thunderstorm.
- `cloudy-and-light-rain` — Cloudy, light rain.
- `overcast-and-light-rain` — Overcast, light rain.
- `cloudy-and-rain` — Cloudy, rain.- `overcast-and-wet-snow` — Sleet.
- `partly-cloudy-and-light-snow` — Light snow.
- `partly-cloudy-and-snow` — Partly cloudy, snow.
- `overcast-and-snow` — Snowfall.
- `cloudy-and-light-snow` — Cloudy, light snow.
- `overcast-and-light-snow` — Overcast, light snow.
- `cloudy-and-snow` — Cloudy, snow. | String ||
|| `wind_speed` | Wind speed (meters per second). | Number ||
|| `wind_gust` | Speed of wind gusts (meters per second). | Number ||
|| `wind_dir` | Wind direction. Possible values:
- “nw” — Northwest.
- “n” — North.
- “ne” — Northeast.
- “e” — East.
- “se” — Southeast.
- “s” — South.
- “sw” — Southwest.
- “w” — West.
- “c” — Calm. | String ||
|| `pressure_mm` | Atmospheric pressure (mm Hg). | Number ||
|| `pressure_pa` | Atmospheric pressure (hPa). | Number ||
|| `humidity` | Humidity (percent). | Number ||
|| `daytime` | Light or dark time of the day. Possible values:
- “d” — Light time of day.
- “n” — Dark time of day. | String ||
|| `polar` | Indicates that the time of day specified in the `daytime` field is polar. | Boolean ||
|| `season` | Time of year in this locality. Possible values:
- “summer” — Summer.
- “autumn” — Autumn.
- “winter” — Winter.
- “spring” — Spring. | String ||
|| `obs_time` | The time when weather data was measured, in Unix time. | Number ||
|| `prec_type` | Type of precipitation. Possible values:
- 0 — No precipitation.
- 1 — Rain.
- 2 — Sleet.
- 3 — Snow. | Number ||
|| `prec_strength` | Intensity of precipitation. Possible values:
- 0 — No precipitation.
- 0.25 — Light rain or snow.
- 0.5 — Rain or snow.
- 0.75 — Heavy rain or snowfall.
- 1 — Heavy downpour or snowstorm. | Number ||
|| `cloudness` | Cloud cover. Possible values:
- 0 — Clear.
- 0.25 — Partly cloudy.
- 0.5 — Cloudy.
- 0.75 — Cloudy.
- 1 — Overcast. | String ||
|#

### forecasts object {#forecasts}

This object contains weather forecast data.

#|
|| **Field** | **Description** | **Format** ||
|| `date` | Date of the forecast, in the format YYYY-MM-DD. | String ||
|| `date_ts` | The date of the forecast in Unix time. | Number ||
|| `week` | Week number. | Number ||
|| `sunrise` | Time of the sunrise in local time (may be omitted for polar regions). | String ||
|| `sunset` | Time of the sunset in local time (may be omitted for polar regions). | String ||
|| `moon_code` | Code of the lunar phase. Possible values:
- 0 — Full moon.
- 1-3 — Waning crescent.
- 4 — Last quarter.
- 5-7 — Waning gibbous.
- 8 — New moon.
- 9-11 — Waxing gibbous.
- 12 — First quarter.
- 13-15 — Waxing crescent. | Number ||
|| `moon_text` | Text code for the lunar phase. Possible values:
- `full-moon` — Full moon.
- `decreasing-moon` — Waning moon.
- `last-quarter` — Last quarter.
- `new-moon` — New moon.
- `growing-moon` — Waxing moon.
- `first-quarter` — First quarter. | String ||
|| `parts` | Forecasts by time of day and 12-hour forecasts.Contains fields that differ by type of forecast:
- [night](*night) — Nighttime forecast.
- morning — Morning forecast.
- day — Afternoon forecast.
- evening — Evening forecast.
- [day_short](*day_short) — 12-hour forecast for the day.
- night_short — Nighttime forecast with the `temp_min` and `temp_max` fields excluded and the `temp` field showing the lowest nighttime temperature.

All weather forecasts for a certain time of day have the same set of fields.

All 12-hour forecasts have the same set of fields.

{% note info %}

For the last day returned in the forecast, some of the parts might be missing.

{% endnote %} | Object ||
|| `night` | Object with the weather forecast for the night. Contains the following fields:
- [temp_min](*temp_min)
- [temp_max](*temp_max)
- [temp_avg](*temp_avg)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [daytime](*daytime)
- [polar](*polar)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_mm](*prec_mm)
- [prec_period](*prec_period)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [cloudness](*cloudness)

{% note alert %}

The beginning of the nighttime period corresponds to the beginning of the 24-hour period. To specify the upcoming night temperatures, use the object for the nighttime forecast for the next day.

{% endnote %} | Object ||
|| `temp_min` | Minimum temperature for the time of day (°C). | Number ||
|| `temp_max` | Maximum temperature for the time of day (°C). | Number ||
|| `temp_avg` | Average temperature for the time of day (°C). | Number ||
|| `feels_like` | What the temperature feels like (°C). | Number ||
|| `icon` | The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/\<value from the icon field\>.svg. | String ||
|| `condition` | The code for the weather description. Possible values:
- `clear` — Clear.
- `partly-cloudy` — Partly cloudy.
- `cloudy` — Cloudy.
- `overcast` — Overcast.
- `partly-cloudy-and-light-rain` — Partly cloudy, light rain.
- `partly-cloudy-and-rain` — Partly cloudy, rain.
- `overcast-and-rain` — Overcast, heavy rain.
- `overcast-thunderstorms-with-rain` — Heavy rain, thunderstorm.
- `cloudy-and-light-rain` — Cloudy, light rain.
- `overcast-and-light-rain` — Overcast, light rain.
- `cloudy-and-rain` — Cloudy, rain.
- `overcast-and-wet-snow` — Sleet.
- `partly-cloudy-and-light-snow` — Light snow.
- `partly-cloudy-and-snow` — Partly cloudy, snow.
- `overcast-and-snow` — Snowfall.
- `cloudy-and-light-snow` — Cloudy, light snow.
- `overcast-and-light-snow` — Overcast, light snow.
- `cloudy-and-snow` — Cloudy, snow. | String ||
|| `daytime` | Light or dark time of the day. Possible values:
- “d” — Light time of day.
- “n” — Dark time of day. | String ||
|| `polar` | Indicates that the time of day specified in the `daytime` field is polar. | Boolean ||
|| `wind_speed` | Wind speed (meters per second). | Number ||
|| `wind_gust` | Speed of wind gusts (meters per second). | Number ||
|| `wind_dir` | Wind direction. Possible values:
- “nw” — Northwest.
- “n” — North.
- “ne” — Northeast.
- “e” — East.
- “se” — Southeast.
- “s” — South.
- “sw” — Southwest.
- “w” — West.
- “c” — Calm. | String ||
|| `pressure_mm` | Atmospheric pressure (mm Hg). | Number ||
|| `pressure_pa` | Atmospheric pressure (hPa). | Number ||
|| `humidity` | Humidity (percent). | Number ||
|| `prec_mm` | Predicted amount of precipitation (mm). | Number ||
|| `prec_period` | Predicted duration of precipitation (minutes). | Number ||
|| `prec_type` | Type of precipitation. Possible values:
- 0 — No precipitation.
- 1 — Rain.
- 2 — Sleet.
- 3 — Snow. | Number ||
|| `prec_strength` | Intensity of precipitation. Possible values:
- 0 — No precipitation.
- 0.25 — Light rain or snow.
- 0.5 — Rain or snow.
- 0.75 — Heavy rain or snowfall.
- 1 — Heavy downpour or snowstorm. | Number ||
|| `cloudness` | Cloud cover. Possible values:
- 0 — Clear.
- 0.25 — Partly cloudy.
- 0.5 — Cloudy.
- 0.75 — Cloudy.
- 1 — Overcast.  | Number ||
|| `day_short` | Object with a 12-hour forecast for the day. Contains the following fields:
- [temp](*temp)
- [temp_min](*temp_min)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [cloudness](*cloudness) | Object ||
|| `temp` | Highest daytime or lowest nighttime temperature (°C). | Number ||
|| `hours` | Object for the hourly forecast. Consists of 24 parts (hours) for the first 2-3 days, then an empty string is returned. Each part contains the following fields:
- [hour](*hour)
- [hour_ts](*hour_ts)
- [temp](*temp)
- [feels_like](*feels_like)
- [icon](*icon)
- [condition](*condition)
- [wind_speed](*wind_speed)
- [wind_gust](*wind_gust)
- [wind_dir](*wind_dir)
- [pressure_mm](*pressure_mm)
- [pressure_pa](*pressure_pa)
- [humidity](*humidity)
- [prec_mm](*prec_mm)
- [prec_period](*prec_period)
- [prec_type](*prec_type)
- [prec_strength](*prec_strength)
- [is_thunder](*is_thunder)
- [cloudness](*cloudness) | Object ||
|| `hour` | The hour the forecast is for (0-23) using the local time. | String ||
|| `hour_ts` | The time of the forecast in Unix time. | Number ||
|#

## Example {#req-example}

Request:

```
GET https://api.weather.yandex.ru/v1/forecast?lat=55.75396&lon=37.620393&extra=true

X-Yandex-Weather-Key: 4pa...3
```

Response:

```
{
  "[now](*now)": 1470220206,
  "[now_dt](*now_dt)": "2016-08-03T10:30:06.238Z",
  "info": {
    "[lat](*lat_2)": 55.833333,
    "[lon](*lon_2)": 37.616667,
    "[tzinfo](*tzinfo)": {
      "[offset](*offset)": 10800,
      "[name](*name)": "Europe/Moscow",
      "[abbr](*abbr)": "MSK",
      "[dst](*dst)": false
    },
    "[def_pressure_mm](*def_pressure_mm)": 746,
    "[def_pressure_pa](*def_pressure_pa)": 994,
    "[url](*url)": "https://yandex.ru/pogoda/moscow"
  },
  "fact": {
    "[temp](*temp)": 20,
    "[feels_like](*feels_like)": 21,
    "[icon](*icon)": "ovc",
    "[condition](*condition)": "overcast",
    "[wind_speed](*wind_speed)": 2,
    "[wind_gust](*wind_gust)": 5.9,
    "[wind_dir](*wind_dir)": "n",
    "[pressure_mm](*pressure_mm)": 745,
    "[pressure_pa](*pressure_pa)": 994,
    "[humidity](*humidity)": 83,
    "[daytime](*daytime)": "d",
    "[polar](*polar)": false,
    "[season](*season)": "summer",
    "[prec_type](*prec_type)": 1,
    "[prec_strength](*prec_strength)": 0.25,
    "[cloudness](*cloudness)": 1,
    "[obs_time](*obs_time)": 1470214800 
  },
  "forecasts": [
    {
      "[date](*date)": "2016-08-03",
      "[date_ts](*date_ts)": 1470171600,
      "[week](*week)": 32,
      "[sunrise](*sunrise)": "04:38",
      "[sunset](*sunset)": "20:31",
      "[moon_code](*moon_code)": 8,
      "[moon_text](*moon_text)": "new-moon",
      "[parts](*parts)": {
        "[night](*night)": {
          "[temp_min](*temp_min)": 20,
          "[temp_max](*temp_max)": 21,
          "[temp_avg](*temp_avg)": 21,
          "[feels_like](*feels_like)": 23,
          "[icon](*icon)": "bkn_n",
          "[condition](*condition)": "cloudy",
          "[daytime](*daytime)": "n",
          "[polar](*polar)": false,
          "[wind_speed](*wind_speed)": 0.9,
          "[wind_gust](*wind_gust)": 4,
          "[wind_dir](*wind_dir)": "nw",
          "[pressure_mm](*pressure_mm)": 746,
          "[pressure_pa](*pressure_pa)": 995,
          "[humidity](*humidity)": 81,
          "[prec_mm](*prec_mm)": 0,
          "[prec_period](*prec_period)": 360,
          "[prec_type](*prec_type)": 0,
          "[prec_strength](*prec_strength)": 0,5,
          "[cloudness](*cloudness)": 0.75
        },
        ...
        "evening": {
          "temp_min": 17,
          "temp_max": 19,
          "temp_avg": 18,
          "feels_like": 19,
          "icon": "ovc_+ra",
          "condition": "overcast-and-rain",
          "daytime": "d",
          "polar": false,
          "wind_speed": 1.8,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 99,
          "prec_mm": 17.95,
          "prec_period": 360,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 0.75,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        "[day_short](*day_short)": {
          "temp": 20,
          "temp_min": 18,
          "feels_like": 21,
          "icon": "bkn_+ra_d",
          "condition": "overcast-and-rain",
          "wind_speed": 1.9,
          "wind_gust": 5.9,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 88,
          "prec_type": 1,
          "prec_strength": 0.25,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        "night_short": {
          "temp": 20,
          "feels_like": 22,
          "icon": "bkn_n",
          "condition": "cloudy",
          "wind_speed": 0.9,
          "wind_gust": 5.9,
          "wind_dir": "nw",
          "pressure_mm": 746,
          "pressure_pa": 995,
          "humidity": 81,
          "prec_type": 1,
          "prec_strength": 0.25,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        }
      },
      "[hours](*hours_2)": [
        {
          "[hour](*hour)": "0",
          "[hour_ts](*hour_ts)": 1470171600,
          "temp": 21,
          "feels_like": 23,
          "icon": "bkn_n",
          "condition": "partly-cloudy",
          "wind_speed": 0.3,
          "wind_gust": 4,
          "wind_dir": "nw",
          "pressure_mm": 746,
          "pressure_pa": 995,
          "humidity": 80,
          "prec_mm": 0,
          "prec_period": 60,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        },
        ...
        {
          "hour": "23",
          "hour_ts": 1470254400,
          "temp": 17,
          "feels_like": 19,
          "icon": "ovc_-ra",
          "condition": "overcast-and-light-rain",
          "wind_speed": 0.9,
          "wind_gust": 3.6,
          "wind_dir": "nw",
          "pressure_mm": 745,
          "pressure_pa": 994,
          "humidity": 100,
          "prec_mm": 0.05,
          "prec_period": 60,
          "prec_type": 1,
          "prec_strength": 0.5,
          "cloudness": 1,
          "_fallback_temp": false,
          "_fallback_prec": false
        }
      ]
    },
    ...
    {
      "date": "2016-08-10",
      "date_ts": 1471035600,
      "week": 33,
      "sunrise": "04:57",
      "sunset": "20:09",
      "moon_code": 13,
      "moon_text": "growing-moon",
      "parts": {
        "night": {...},
        "morning": {...},
        "day": {...},
        "evening": {...},
        "day_short": {...},
        "night_short": {...}
      },
      "hours": [...]
    }
  ]
}
```


[*prec_prob]:
 
**Description**
 
Chance of precipitation.
 
**Format**
 
Number

[*temp_min]:
 
**Description**
 
Minimum temperature for the time of day (°C).
 
**Format**
 
Number

[*temp_max]:
 
**Description**
 
Maximum temperature for the time of day (°C).
 
**Format**
 
Number

[*temp_avg]:
 
**Description**
 
Average temperature for the time of day (°C).
 
**Format**
 
Number

[*feels_like]:
 
**Description**
 
What the temperature feels like (°C).
 
**Format**
 
Number

[*icon]:
 
**Description**
 
The code of the weather icon. The icon is available at https://yastatic.net/weather/i/icons/funky/dark/\<value from the icon field\>.svg.
 
**Format**
 
String

[*polar]:
 
**Description**
 
Indicates that the time of day specified in the `daytime` field is polar.
 
**Format**
 
Boolean

[*wind_speed]:
 
**Description**
 
Wind speed (meters per second).
 
**Format**
 
Number

[*wind_gust]:
 
**Description**
 
Speed of wind gusts (meters per second).
 
**Format**
 
Number

[*pressure_mm]:
 
**Description**
 
Atmospheric pressure (mm Hg).
 
**Format**
 
Number

[*pressure_pa]:
 
**Description**
 
Atmospheric pressure (hPa).
 
**Format**
 
Number

[*humidity]:
 
**Description**
 
Humidity (percent).
 
**Format**
 
Number

[*prec_mm]:
 
**Description**
 
Predicted amount of precipitation (mm).
 
**Format**
 
Number

[*prec_period]:
 
**Description**
 
Predicted duration of precipitation (minutes).
 
**Format**
 
Number

[*part_name]:
 
**Description**
 
Name of the time of day. Possible values:
- `night` — Night.
- `morning` — Morning.
- `day` — Day.
- `evening` — Evening.
 
**Format**
 
String

[*condition]:
 
**Description**
 
The code for the weather description. Possible values:
- `clear` — Clear.
- `partly-cloudy` — Partly cloudy.
- `cloudy` — Cloudy.- `overcast` — Overcast.
- `drizzle` — Drizzle.
- `light-rain` — Light rain.
- `rain` — Rain.
- `moderate-rain` — Moderate rain.
- `heavy-rain` — Heavy rain.
- `continuous-heavy-rain` — Continuous heavy rain.
- `showers` — Showers.- `wet-snow` — Sleet.
- `light-snow` — Light snow.
- `snow` — Snow.
- `snow-showers` — Snowfall.
- `hail` — Hail.
- `thunderstorm` — Thunderstorm.
- `thunderstorm-with-rain` — Rain, thunderstorm.
- `thunderstorm-with-hail` — Thunderstorm, hail.
 
**Format**
 
String

[*daytime]:
 
**Description**
 
Light or dark time of the day. Possible values:
- “d” — Light time of day.
- “n” — Dark time of day.
 
**Format**
 
String

[*wind_dir]:
 
**Description**
 
Wind direction. Possible values:
- “nw” — Northwest.
- “n” — North.
- “ne” — Northeast.
- “e” — East.
- “se” — Southeast.
- “s” — South.
- “sw” — Southwest.
- “w” — West.
- “c” — Calm.
 
**Format**
 
String

[*lat]: The latitude in degrees. Required field.

[*lon]: The longitude in degrees. Required field.

[*lat_2]:
 
**Description**
 
The latitude (in degrees).
 
**Format**
 
Number

[*lon_2]:
 
**Description**
 
The longitude (in degrees).
 
**Format**
 
Number

[*lang]:
 
The combination of language and country that weather information will be returned for. Possible values:
 
- “ru_RU” — Russian for the Russia locale.
- “be_BY” — Belarusian for the Belarus locale.
- “kk_KZ” — Kazakh for the Kazakhstan locale.
- “tr_TR” — Turkish for the Turkey locale.
- “en_US” — International English.

[*X_Yandex_Weather_Key]: The key you received when [enabling the Yandex.Weather API](https://yandex.com/dev/weather/doc/en/concepts/api.md#onboarding).

[*now]:
 
**Description**
 
The time on the server in Unix time.
 
**Format**
 
Number

[*now_dt]:
 
**Description**
 
The time on the server in UTC.
 
**Format**
 
String

[*url]:
 
**Description**
 
Locality page on [Yandex Weather](https://yandex.com/pogoda/en-US?lat=53.339046&lon=83.69133).
 
**Format**
 
String

[*temp]:
 
**Description**
 
Temperature (°C).
 
**Format**
 
Number

[*season]:
 
**Description**
 
Time of year in this locality. Possible values:
- “summer” — Summer.
- “autumn” — Autumn.
- “winter” — Winter.
- “spring” — Spring.
 
**Format**
 
String

[*obs_time]:
 
**Description**
 
The time when weather data was measured, in Unix time.
 
**Format**
 
Number

[*date]:
 
**Description**
 
Date of the forecast, in the format YYYY-MM-DD.
 
**Format**
 
String

[*date_ts]:
 
**Description**
 
The date of the forecast in Unix time.
 
**Format**
 
Number

[*week]:
 
**Description**
 
Week number.
 
**Format**
 
Number

[*sunrise]:
 
**Description**
 
Time of the sunrise in local time (may be omitted for polar regions).
 
**Format**
 
String

[*sunset]:
 
**Description**
 
Time of the sunset in local time (may be omitted for polar regions).
 
**Format**
 
String

[*moon_code]:
 
**Description**
 
Code of the lunar phase. Possible values:
- 0 — Full moon.
- 1-3 — Waning crescent.
- 4 — Last quarter.
- 5-7 — Waning gibbous.
- 8 — New moon.
- 9-11 — Waxing gibbous.
- 12 — First quarter.
- 13-15 — Waxing crescent.
 
**Format**
 
Number

[*moon_text]:
 
**Description**
 
Text code for the lunar phase. Possible values:
- `moon-code-0` — Full moon.
- `moon-code-1` — Waning moon.
- `moon-code-2` — Waning moon.
- `moon-code-3` — Waning moon.
- `moon-code-4` — Last quarter.
- `moon-code-5` — Waning moon.
- `moon-code-6` — Waning moon.
- `moon-code-7` — Waning moon.
- `moon-code-8` — New moon.
- `moon-code-9` — Waxing moon.
- `moon-code-10` — Waxing moon.
- `moon-code-11` — Waxing moon.
- `moon-code-12` — First quarter.
- `moon-code-13` — Waxing moon.
- `moon-code-14` — Waxing moon.
- `moon-code-15` — Waxing moon.
 
**Format**
 
String

[*prec_period]:
 
**Description**
 
Predicted duration of precipitation (minutes).
 
**Format**
 
Number

[*limit]:
 
**Description**
 
The number of days in the forecast, including the current day.
 
For the “[Test](https://yandex.com/dev/weather/doc/en/concepts/pricing.md#test)” rate, the maximum value is 7.
 
**Format**
 
Number

[*hours]:
 
For each day, the response will contain the hourly weather forecast. Possible values:
- “true” — Default value. Returns the hourly forecast.
- “false” — Does not return the hourly forecast.

[*extra]:
 
**Description**
 
Extra information about precipitation. Possible values:
- <true> — Returns detailed information about precipitation.
- <false> — Default value. Does not return detailed information about precipitation.
 
**Format**
 
Number

[*offset]:
 
**Description**
 
Time zone in seconds from UTC.
 
**Format**
 
Number

[*name]:
 
**Description**
 
Name of the time zone.
 
**Format**
 
String

[*abbr]:
 
**Description**
 
Abbreviated name of the time zone.
 
**Format**
 
String
 
[*dst]:
 
**Description**
 
Daylight saving time.
 
**Format**
 
Boolean
 
[*night]:
 
**Description**
 
Object with the weather forecast for the night. Contains the following fields:
 
- `temp_min`
- `temp_max`
- `temp_avg`
- `feels_like`
- `icon`
- `condition`
- `daytime`
- `polar`
- `wind_speed`
- `wind_gust`
- `wind_dir`
- `pressure_mm`
- `pressure_pa`
- `humidity`
- `prec_mm`
- `prec_period`
- `prec_type`
- `prec_strength`
- `cloudness`
 
{% note alert %}
 
The beginning of the nighttime period corresponds to the beginning of the 24-hour period. To specify the upcoming night temperatures, use the object for the nighttime forecast for the next day.
 
{% endnote %}
 
**Format**
 
Object

[*day_short]:
 
**Description**
 
Object with a 12-hour forecast for the day. Contains the following fields:
 
- `temp`
- `temp_min`
- `feels_like`
- `icon`
- `condition`
- `wind_speed`
- `wind_gust`
- `wind_dir`
- `pressure_mm`
- `pressure_pa`
- `humidity`
- `prec_type`
- `prec_strength`
- `cloudness`
 
**Format**
 
Object

[*prec_type]:
 
**Description**
 
Type of precipitation. Possible values:
- 0 — No precipitation.
- 1 — Rain.
- 2 — Sleet.
- 3 — Snow.
 
**Format**
 
Number

[*prec_strength]:
 
**Description**
 
Intensity of precipitation. Possible values:
- 0 — No precipitation.
- 0.25 — Light rain or snow.
- 0.5 — Rain or snow.
- 0.75 — Heavy rain or snowfall
- 1 — Heavy downpour or snowstorm.
 
**Format**
 
Number

[*cloudness]:
 
**Description**
 
Cloud cover. Possible values:
- 0 — Clear.
- 0.25 — Partly cloudy.
- 0.5 — Cloudy.
- 0.75 — Cloudy.
- 1 — Overcast.
 
**Format**
 
Number

[*hour]:
 
**Description**
 
The hour the forecast is for (0-23) using the local time.
 
**Format**
 
String

[*hour]:
 
**Description**
 
The time of the forecast in Unix time.
 
**Format**
 
Number

[*is_thunder]:
 
**Description**
 
Indicates a thunderstorm. Possible values:
- true — Thunderstorm.
- false — No thunderstorm.
 
**Format**
 
Boolean

[*tzinfo]:
 
**Description**
 
Information about the time zone. Contains the fields `offset`, `name`, `abbr` and `dst`.
 
**Format**
 
Object

[*def_pressure_mm]:
 
**Description**
 
The normal pressure for the given coordinates (mm Hg).
 
**Format**
 
Number

[*def_pressure_pa]:
 
**Description**
 
The normal pressure for the given coordinates (hPa).
 
**Format**
 
Number

[*parts]:
 
**Description**
 
Forecasts by time of day and 12-hour forecasts.
 
Contains fields that differ by type of forecast:
- night — Nighttime forecast.
- morning — Morning forecast.
- day — Afternoon forecast.
- evening — Evening forecast.
- day_short — 12-hour forecast for the day.
- night_short — Nighttime forecast with the `temp_min` and `temp_max` fields excluded and the `temp` field showing - the lowest nighttime temperature.
 
All weather forecasts for a certain time of day have the same set of fields.
 
All 12-hour forecasts have the same set of fields.
 
{% note info %}
 
For the last day returned in the forecast, some of the parts might be missing.
 
{% endnote %}
 
**Format**
 
Object

[*hour_ts]:
 
**Description**
 
The time of the forecast in Unix time.
 
**Format**
 
Number

[*hours_2]:
 
**Description**
 
Object for the hourly forecast. Consists of 24 parts (hours) for the first 2-3 days, then an empty string is returned. Each part contains the following fields:
- hour
- hour_ts
- temp
- feels_like
- icon
- condition
- wind_speed
- wind_gust
- wind_dir
- pressure_mm
- pressure_pa
- humidity
- prec_mm
- prec_period
- prec_type
- prec_strength
- is_thunder
- cloudness
 
**Format**
 
Object