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

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

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

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

```bash
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://mcp-everything.ru/integrations/yandex-metrika/scenarios/poluchit-poseschaemost-i-istochniki.md)
- [Посчитать конверсию по целям](https://mcp-everything.ru/integrations/yandex-metrika/scenarios/poschitat-konversiyu-po-tselyam.md)
- [Выгрузить сырые визиты через Logs API](https://mcp-everything.ru/integrations/yandex-metrika/scenarios/vygruzit-syrye-vizity-cherez-logs-api.md)

---

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