API документация · /yandex/metrika · 342 документа
API Яндекс Метрики: Документация для разработчиков: отчёты, управление счётчиками, импорт данных и Logs API
Методы API отчётов и API управления, загрузка офлайн-конверсий, расходов и данных из CRM, выгрузка сырых визитов и событий через Logs API, OAuth-доступы и квоты. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на yandex.ru/dev/metrika.
Паспорт источника
- Service ID
/yandex/metrika- Источник
- yandex.ru — официальная документация
- Документов
- 342
- Состав
- 342 страницы · 108 методов · 186 карточек группировок и метрик
- Проверка источника
- 15.03.2026
- Версия API
- не подтверждена
API Яндекс Метрики — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:
Весь каталог: 25 источников →Что включено
342 документа API Яндекс Метрики в одном поиске
Сохранённые копии yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.
Введение и архитектура API
10Быстрый старт, авторизация и OAuth-доступы, квоты, вызов методов, версионирование, ошибки, частые вопросы, работа с логином.
- Быстрый старт
- Авторизация
- Квотирование
API управления
104Счётчики, цели, фильтры, метки, доступы и представители, офлайн-конверсии, звонки, чаты, расходы, параметры посетителей, сегменты.
- GET /management/v1/counters
- Создание цели
- Загрузка офлайн-конверсий
API импорта данных
14Передача данных о клиентах и заказах из CRM, форматы и режимы загрузки, хеширование, Measurement Protocol.
- Данные о клиентах из CRM
- Measurement Protocol
- Хеширование (md5)
API отчётов
15Таблица, данные по времени, drill down, сравнение сегментов и сводная таблица; сегментация, семплирование, шаблоны, примеры.
- GET /stat/v1/data
- Сегментация
- Семплирование
Группировки и метрики
186Карточки справочника API отчётов: группировки визитов, хитов и событий, метрики визитов, рекламы и расходов.
- Группировки визитов и хитов
- Метрики визитов
- Метрики рекламы и расходов
Logs API
13Неагрегированные визиты и события: создание, оценка, статус, выгрузка и очистка запросов логов, поля, подключение к ClickHouse.
- Создание запроса логов
- Сценарий работы с Logs API
- Подключение к ClickHouse
С чего начать
Как получить токен и выгрузить данные через Logs API: пять шагов
Коротко по разделам «Авторизация» и «Сценарий работы с Logs API» на yandex.ru/dev/metrika. Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.
- Создайте приложениеВ Яндекс ID выберите «Для доступа к API или отладки» и укажите доступы: metrika:read — для статистики, metrika:write — для изменения счётчиков и загрузки данных. Скопируйте ClientID.
- Получите токенПодставьте ClientID в ссылку oauth.yandex.ru/authorize?response_type=token&client_id=… и скопируйте токен. Передавайте его в каждом запросе в заголовке Authorization: OAuth.
- Создайте запрос логовPOST /management/v1/counter/{counterId}/logrequests с source (hits или visits), date1, date2 и fields. Не уверены в объёме — сначала проверьте его запросом evaluate.
- Дождитесь подготовкиСохраните request_id и проверяйте статус запросом GET …/logrequest/{requestId}. Лог со статусом processed готов к выгрузке.
- Скачайте и очиститеВыгрузите части лога через …/part/{partNumber}/download, затем вызовите …/clean, чтобы освободить место для следующих запросов.
Ограничения Logs API
- Период в запросе
- Не более 1 года
- Поле fields
- До 3000 символов
- Объём выгрузки
- 10 ГБ на подготовленные логи
Статистика за текущий день недоступна — документация рекомендует запрашивать данные за предыдущий день и ранее. Чтобы увеличить квоту, подключите Метрику Про.
yandex.ru/dev/metrika/ru/logs/Чаще всего у приложения нет доступа metrika:read или metrika:write, токен выпущен для другого аккаунта или у владельца токена нет доступа к счётчику. Разбор — в разделе «Авторизация».
Документация
Частые задачи: методы и руководства
Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу yandex.ru.
Методы API Метрики
7 из 108- GET
/stat/v1/dataСтатистические данные Метрики в виде таблицы - GET
/management/v1/countersСписок счётчиков, доступных пользователю - POST
/management/v1/counter/{counterId}/goalsСоздание цели счётчика - POST
/management/v1/counter/{counterId}/logrequestsСоздание запроса логов в Logs API - POST
/management/v1/counter/{counterId}/offline_conversions/uploadЗагрузка офлайн-конверсий: BASIC, CALLS или CHATS - POST
/management/v1/counter/{counterId}/expense/uploadЗагрузка расходов как multipart/form-data - POST
/management/v1/counter/{counterId}/grantsРазрешение на управление счётчиком и просмотр статистики
Руководства
7 из 342- Быстрый старт
yandex.ru/dev/metrika/ru/intro/quick-start - Авторизация
yandex.ru/dev/metrika/ru/intro/authorization - Квотирование
yandex.ru/dev/metrika/ru/intro/quotas - Сценарий работы с Logs API
yandex.ru/dev/metrika/ru/logs/practice/quick-start - Подключение Logs API к ClickHouse
yandex.ru/dev/metrika/ru/logs/clickhouse-integration - Передача офлайн-конверсий
yandex.ru/dev/metrika/ru/management/offline-conv - Как передавать данные о клиентах и заказах из CRM
yandex.ru/dev/metrika/ru/data-import/contacts
Как использовать
Три способа работать с документацией API Яндекс Метрики
Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.
01 · На сайте
Поиск без регистрации
Выберите API Яндекс Метрики в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.
API Яндекс Метрики · 342 → выгрузить визиты через Logs API02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на Python скрипт: создать запрос Logs API за прошлую неделю, дождаться processed, скачать части и очистить. Сверь методы с yandex.ru/dev/metrika»
resolve_service → search_docs → get_document03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → GET /stat/v1/data
API Яндекс Метрики /yandex/metrika
GET /stat/v1/data
Предоставляет доступ к статистическим данным Яндекс Метрики, включая данные, доступные в отчетах. Возвращает результат в виде таблицы.
Параметры
idsinteger[]- Идентификаторы счётчиков через запятую.
metricsstring- Список метрик через запятую. Лимит — 20 метрик в запросе.
dimensionsstring- Список группировок через запятую. Лимит — 10 группировок в запросе.
Подключение
Подключите документацию API Яндекс Метрики к ИИ-агенту
Один MCP-сервер Bridge8 — и агент знает API Яндекс Метрики и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.
Как подключить за минуту
- Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
- Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
- Спросите про API Яндекс Метрики«Найди в API Яндекс Метрики, как выгрузить сырые визиты через Logs API, и покажи ссылку на источник».
Bridge8 не подключается к вашим счётчикам, не выгружает статистику и не загружает данные в Метрику, не выдаёт и не хранит OAuth-токены. Агент получает документацию и сам пишет код.
claude mcp add --transport http bridge8 \
https://bridge8.ru/mcp \
--header "Authorization: Bearer <TOKEN>"{
"mcpServers": {
"bridge8": {
"type": "http",
"url": "https://bridge8.ru/mcp",
"headers": {
"Authorization": "Bearer <TOKEN>"
}
}
}
}Инструменты сервера — в порядке вызова
resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.get_documentЧитает документ целиком, постранично, со ссылкой на источник.
Вопросы
Вопросы о API Яндекс Метрики
Какие API есть у Метрики?
По «Быстрому старту»: API управления — счётчики, цели, фильтры и другие объекты; API импорта данных — клиенты и заказы из CRM, звонки, офлайн-конверсии, параметры посетителей; API отчётов — статистика с сегментацией; Logs API — неагрегированные данные для собственной обработки.
Как получить OAuth-токен для API Метрики?
Создайте приложение в Яндекс ID («Для доступа к API или отладки») с доступом metrika:read, а для изменений — metrika:write. Подставьте ClientID в ссылку oauth.yandex.ru/authorize?response_type=token&client_id=… и скопируйте токен. Без токена или с недействительным токеном API отвечает 401.
Чем Logs API отличается от API отчётов?
API отчётов возвращает агрегированную статистику — например, таблицу метрик по группировкам через /stat/v1/data. Logs API отдаёт неагрегированные визиты и события для собственной обработки, например в ClickHouse. Данные за текущий день Logs API не выдаёт.
Какие квоты действуют на API?
По разделу «Квоты»: с одного IP — 30 запросов в секунду к API и 10 к Logs API. На пользователя — 3 параллельных запроса и 5000 в сутки (сброс в 00:00 по Гринвичу), к API отчётов — 200 запросов за 5 минут. При превышении API возвращает 429 Too Many Requests.
Какие ограничения у Logs API?
Период в одном запросе — не более 1 года, поле fields — до 3000 символов, общая квота на подготовленные логи — 10 ГБ. Чтобы освободить место, удаляйте подготовленные и скачанные логи; чтобы увеличить квоту, подключите Метрику Про.
Нужно ли загружать в Метрику расходы Директа?
Нет: «Данные Директа загружать не нужно — они передаются в Метрику автоматически». Если загрузить их файлом, данные задублируются и отчёт станет некорректным.
Это официальный сайт Яндекса?
Нет. Bridge8 хранит копию официальной документации yandex.ru/dev/metrika для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена.
Bridge8 может выгрузить мою статистику?
Нет. Bridge8 — документация для разработчиков: он не подключается к Метрике от вашего имени, не выдаёт и не хранит токены, не читает и не загружает данные счётчиков.
Ещё в Bridge8
Связанные источники и все API
Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.
Другие API в Bridge8
16 API · 5 416 документовЯндекс
7 APIVK и MAX
3 APICRM, телефония, банк
3 APIОбъявления и рассылки
3 APIСправка и курсы
8 источниковСправка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.
Каталог на главной