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

Тип: 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://yandex.ru/dev/metrika/ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-metrika.md