# API Яндекс Метрики: 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 | нет | Включать примечания |

## Базовые URL

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

## Авторизация

Тип: OAuth 2.0

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

```
Authorization: OAuth <токен>
```

## Нюансы

- Префиксы метрик и группировок: `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/postroit-grafik-poseschaemosti-po-dnyam.md)

---

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