API Яндекс Метрики: Построить график посещаемости по дням

Сценарий из mcp-everything. Актуально на 2026-10-24.

Динамика визитов или конверсий во времени для графика.

Запроси данные: GET /stat/v1/data/bytime с теми же ids, metrics и датами плюс group = day (или week, month, hour).
В ответе для каждой метрики — массив значений по периодам; даты периодов — в time_intervals.
С dimensions можно получить отдельные ряды по группировке (например, по источникам): top_keys задаёт, сколько рядов вернуть (до 30).

curl -G https://api-metrika.yandex.net/stat/v1/data/bytime \
  -H "Authorization: OAuth $METRIKA_TOKEN" \
  -d ids=44147844 -d metrics=ym:s:visits -d date1=30daysAgo -d date2=yesterday -d group=day

Базовые URL

Боевой: https://api-metrika.yandex.net

Авторизация

Тип: OAuth 2.0

OAuth-токен Яндекса передаётся в заголовке Authorization в каждом запросе. Без токена или с недействительным токеном сервер отвечает 401.

Authorization: OAuth <токен>

Методы сценария

GET /stat/v1/data/bytime — Данные по времени

Параметры как у /stat/v1/data, плюс:

Также доступны GET /stat/v1/data/drilldown (ветвь древовидного отчёта), /stat/v1/data/comparison и /stat/v1/data/comparison/drilldown (сравнение сегментов).

Параметр	Где	Тип	Обяз.	Описание
`group`	query	string	нет	Шаг разбивки: all, auto, minute, hour, day, week (по умолчанию), month, quarter, year и др.
`top_keys`	query	string	нет	Число строк без row_ids, по умолчанию 7, максимум 30
`row_ids`	query	array	нет	Выбор строк для графиков
`include_annotations`	query	string	нет	Включать примечания

Нюансы

Префиксы метрик и группировок: ym:s: — визиты, ym:pv: — хиты; смешивать их в одном запросе нельзя.
Социально-демографические данные выдаются только при выборке больше 10 посетителей; признак ограничения — contains_sensitive_data: true.
Logs API: период запроса — не больше 1 года, date2 не может быть текущим днём, фильтрации на уровне запроса нет.
Поток выгрузки логов: evaluate → создание запроса → опрос статуса до processed → скачивание частей → clean.
Ограничения фильтров отчётов: до 20 фильтров, до 10 000 символов в строке, до 100 значений в одном условии.

Другие сценарии

Если этого недостаточно — официальная документация: https://yandex.ru/dev/metrika/ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-metrika.md