# API Яндекс Метрики: GET /stat/v1/data — Отчёт «Таблица»

В ответе: `data[]` (`dimensions[]` и `metrics[]`), `totals`, `total_rows`, `sampled`, `sample_share`, `query`, `contains_sensitive_data` и др.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `ids` | query | array | нет | ID счётчиков через запятую |
| `metrics` | query | string | нет | Метрики через запятую, до 20 |
| `dimensions` | query | string | нет | Группировки через запятую, до 10 |
| `date1` | query | string | нет | Начало периода: YYYY-MM-DD, today, yesterday, ndaysAgo; по умолчанию 6daysAgo |
| `date2` | query | string | нет | Конец периода, по умолчанию today |
| `filters` | query | string | нет | Фильтр сегментации |
| `sort` | query | string | нет | Поля сортировки; - — по убыванию |
| `limit` | query | string | нет | Строк на странице, по умолчанию 100, максимум 100 000 |
| `offset` | query | string | нет | Первая строка (с 1) |
| `accuracy` | query | string | нет | Размер выборки (семплирование) |
| `preset` | query | string | нет | Шаблон отчёта, например sources_summary |
| `lang` | query | string | нет | Язык ответа |
| `timezone` | query | string | нет | Часовой пояс ±hh:mm, + передаётся как %2B |
| `direct_client_logins` | query | array | нет | Логины клиентов Яндекс Директа |
| `include_undefined` | query | boolean | нет | Строки с неопределёнными значениями |
| `proposed_accuracy` | query | boolean | нет | Разрешить API повышать accuracy |

Пример запроса:

```
https://api-metrika.yandex.net/stat/v1/data.csv?id=44147844&metrics=ym:s:avgPageViews&dimensions=ym:s:operatingSystem&limit=5
```

## Базовые 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/poluchit-poseschaemost-i-istochniki.md)
- [Посчитать конверсию по целям](https://mcp-everything.ru/integrations/yandex-metrika/scenarios/poschitat-konversiyu-po-tselyam.md)

---

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