{"name":"API Яндекс Погоды","vendor":"Яндекс","industry":"maps","summary":"HTTP-интерфейс доступа к погодным данным Яндекс Погоды (версия v3): фактическая погода и прогноз по координатам точки — по дням, частям дня и часам. Запросы пишутся на языке GraphQL, ответы приходят в JSON. Доступ платный по тарифам, есть одноразовый тестовый тариф для новых пользователей.","docsUrl":"https://yandex.ru/dev/weather/doc/ru/concepts/index-v3","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"uznat-tekuschuyu-pogodu-v-tochke","title":"Узнать текущую погоду в точке","summary":"Показать погоду на сайте, учесть дождь в логистике или рекламе — по координатам.","steps":["Создай ключ в консоли Яндекс Погоды (https://yandex.ru/pogoda/b2b/console), выбрав «API Погодных Данных». Он активируется через несколько минут. Доступ платный, для новых клиентов есть тестовый тариф.","Отправь GraphQL-запрос: POST /graphql/query с заголовком X-Yandex-Weather-Key и JSON-полем query. Точка задаётся в weatherByPoint(request: { lat, lon }), фактическая погода — в блоке now.","Выбирай нужные поля: temperature, humidity, pressure, windSpeed, windDirection, cloudiness, precType, precStrength. Единицы задаются аргументами, например temperature(unit: FAHRENHEIT).","Ответ — в data.weatherByPoint.now. Делай запросы со своего сервера: из браузера ключ виден, а запросы упадут с ошибкой CORS."],"code":"curl -X POST https://api.weather.yandex.ru/graphql/query \\\n  -H \"X-Yandex-Weather-Key: $YA_WEATHER_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"query\": \"{ weatherByPoint(request: { lat: 55.7558, lon: 37.6173 }) { now { temperature humidity pressure windSpeed windDirection cloudiness precType } } }\"}'","language":"bash","methods":["POST /graphql/query"]},{"id":"poluchit-pochasovoy-prognoz","title":"Получить почасовой прогноз","summary":"Прогноз на ближайшие дни по часам — для планирования доставки, мероприятий или выездных работ.","steps":["Отправь запрос: POST /graphql/query с блоком forecast { days(limit: N) { hours { ... } } } внутри weatherByPoint. limit задаёт число дней прогноза.","Для каждого часа выбери поля: time, temperature, humidity, pressure, windSpeed, windDirection.","Ответ — в data.weatherByPoint.forecast.days[].hours[]; time — в часовом поясе точки.","Набор доступных полей зависит от тарифа: если поле недоступно, запрос вернёт ошибку — проверь схему в консоли API."],"code":"import requests\n\nquery = \"\"\"\n{ weatherByPoint(request: { lat: 55.7558, lon: 37.6173 }) {\n    forecast { days(limit: 2) { hours { time temperature humidity windSpeed windDirection } } }\n} }\n\"\"\"\nr = requests.post(\"https://api.weather.yandex.ru/graphql/query\",\n                  headers={\"X-Yandex-Weather-Key\": \"<ключ>\"}, json={\"query\": query}).json()\nfor day in r[\"data\"][\"weatherByPoint\"][\"forecast\"][\"days\"]:\n    for h in day[\"hours\"]:\n        print(h[\"time\"], h[\"temperature\"], h[\"windSpeed\"])","language":"python","methods":["POST /graphql/query"]}],"baseUrls":[{"label":"Боевой","url":"https://api.weather.yandex.ru"},{"label":"Схему GraphQL и тестовые запросы можно посмотреть в консоли API ().","url":"https://yandex.ru/pogoda/b2b/console"}],"auth":{"type":"api_key","description":"Ключ создают в Кабинете разработчика (`https://yandex.ru/pogoda/b2b/console`), выбрав «API Погодных Данных»; активируется через несколько минут. Ключ передаётся в заголовке `X-Yandex-Weather-Key`.","example":"X-Yandex-Weather-Key: <Key>"},"methods":[{"id":"POST /graphql/query","title":"GraphQL-запрос погоды","httpMethod":"POST","path":"/graphql/query","description":"Текст GraphQL-запроса передаётся в теле POST-запроса, в JSON-поле `query`. Точка задаётся в `weatherByPoint(request: { lat, lon })`; внутри выбираются `now` (фактическая погода) и/или `forecast` (прогноз).\n\nПример запроса (текущая температура):\n\nПример запроса (почасовой прогноз):","params":[{"name":"X-Yandex-Weather-Key","in":"header","type":"string","required":true,"description":"Ключ доступа"},{"name":"query","in":"body","type":"string","required":true,"description":"Текст GraphQL-запроса"}],"requestExample":"{\n  weatherByPoint(request: { lat: 52.37125, lon: 4.89388 }) {\n    now {\n      temperature\n    }\n  }\n}","responseExample":"{\n  \"data\": {\n    \"weatherByPoint\": {\n      \"now\": {\n        \"temperature\": 20\n      }\n    }\n  }\n}","docsUrl":""}],"codeExamples":[],"errors":[{"code":"403","description":"Нет заголовка X-Yandex-Weather-Key, неверный URL для тарифа, истёк тестовый тариф или превышен лимит запросов"}],"limits":"Тарифы действуют только для новых клиентов; цены — на странице тарифов.","gotchas":["Поля `now`: `temperature`, `humidity`, `pressure`, `precType`, `precStrength`, `windSpeed`, `windDirection`, `cloudiness` и др.; единицы задаются аргументами, например `temperature(unit: FAHRENHEIT)` (`TemperatureUnit`, `PressureUnit`, `WindSpeedUnit`).","`days(limit: N)` — сколько дней прогноза вернуть (необязательный аргумент).","Поля `...OnHeight` (например, `temperatureOnHeight`) принимают аргумент `height`; подбирается ближайшая доступная высота.","API не предназначено для запросов из браузера пользователя: ключ виден в инструментах браузера, а запросы падают с ошибкой CORS. Делайте запросы через свой сервер.","Набор доступных полей зависит от тарифа.","Старая версия v2 использует адреса `https://api.weather.yandex.ru/v2/forecast/` (тариф «Тестовый») и `https://api.weather.yandex.ru/v2/informers/` («Погода на вашем сайте»)."],"slug":"yandex-weather","version":2,"updatedAt":"2026-10-24T17:05:42.216Z","sources":[{"title":"API Яндекс Погоды (v3)","url":"https://yandex.ru/dev/weather/doc/ru/concepts/index-v3","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Аутентификация","url":"https://yandex.ru/dev/weather/doc/ru/concepts/auth","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Использование","url":"https://yandex.ru/dev/weather/doc/ru/concepts/how-to","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Фактическая погода","url":"https://yandex.ru/dev/weather/doc/ru/concepts/fact","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Прогноз","url":"https://yandex.ru/dev/weather/doc/ru/concepts/forecast","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Возможные ошибки","url":"https://yandex.ru/dev/weather/doc/ru/concepts/errors","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Тарифы доступа","url":"https://yandex.ru/dev/weather/doc/ru/concepts/pricing","kind":"research","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-14T14:56:51.694Z"},{"title":"scenarios-yandex-weather.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:31.075Z"}],"logoUrl":null}