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

# API Яндекс Погоды

## Основные положения {#definitions}

- API Яндекс Погоды представляет собой HTTP-интерфейс доступа к погодным данным.
- Результаты запросов в API Яндекс Погоды возвращаются в JSON формате.
- Для получения данных необходима [авторизация](https://yandex.com/dev/weather/doc/ru/concepts/auth.md). Для авторизации доступа к API используется [ключ](https://yandex.com/dev/weather/doc/ru/concepts/auth.md#auth-key), который необходимо передать в заголовке HTTP-запроса.
- Основной сценарий использования API – получение информации о выбранной [географической точке](https://yandex.com/dev/weather/doc/ru/concepts/geography.md) в данный момент или прогноза для этой точки на будущее. Для получения погодных данных в конкретной географической точке в запросе необходимо передать координаты (широту и долготу) этой точки.
- API Яндекс Погоды может предоставить много информации о состоянии погоды в точке. В запросе через параметры запроса необходимо явно указывать, какая информация требуется.
- Для задания параметров запроса используется язык запросов [GraphQL](https://graphql.org/).
- GraphQL-схема так же определяет формат ответа. Подробнее изучить схему и попробовать сделать запросы можно на странице [API Яндекс Погоды](https://yandex.ru/pogoda/b2b/console/api-page).

## API Яндекс Погоды для сайта {#definitions}

- Если данные о погоде будут общедоступными (доступны третьим лицам), необходимо соблюдать правила брендирования. В противном случае сервис оставляет за собой право ограничить доступ к полученным данным.

### Что дальше {#what-next}
[Как начать пользоваться](https://yandex.com/dev/weather/doc/ru/concepts/how-to.md)