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
не подтверждена
yandex.ru/dev/metrika/ru/

Что включено

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 или у вашего ИИ-агента.

  1. Создайте приложениеВ Яндекс ID выберите «Для доступа к API или отладки» и укажите доступы: metrika:read — для статистики, metrika:write — для изменения счётчиков и загрузки данных. Скопируйте ClientID.
  2. Получите токенПодставьте ClientID в ссылку oauth.yandex.ru/authorize?response_type=token&client_id=… и скопируйте токен. Передавайте его в каждом запросе в заголовке Authorization: OAuth.
  3. Создайте запрос логовPOST /management/v1/counter/{counterId}/logrequests с source (hits или visits), date1, date2 и fields. Не уверены в объёме — сначала проверьте его запросом evaluate.
  4. Дождитесь подготовкиСохраните request_id и проверяйте статус запросом GET …/logrequest/{requestId}. Лог со статусом processed готов к выгрузке.
  5. Скачайте и очиститеВыгрузите части лога через …/part/{partNumber}/download, затем вызовите …/clean, чтобы освободить место для следующих запросов.

Ограничения Logs API

Период в запросе
Не более 1 года
Поле fields
До 3000 символов
Объём выгрузки
10 ГБ на подготовленные логи

Статистика за текущий день недоступна — документация рекомендует запрашивать данные за предыдущий день и ранее. Чтобы увеличить квоту, подключите Метрику Про.

yandex.ru/dev/metrika/ru/logs/
403 после получения токена?

Чаще всего у приложения нет доступа metrika:read или metrika:write, токен выпущен для другого аккаунта или у владельца токена нет доступа к счётчику. Разбор — в разделе «Авторизация».

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу yandex.ru.

Методы API Метрики

7 из 108
Все 108 методов в поиске

Как использовать

Три способа работать с документацией API Яндекс Метрики

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

  1. 01 · На сайте

    Поиск без регистрации

    Выберите API Яндекс Метрики в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.

    API Яндекс Метрики · 342 → выгрузить визиты через Logs API
  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Напиши на Python скрипт: создать запрос Logs API за прошлую неделю, дождаться processed, скачать части и очистить. Сверь методы с yandex.ru/dev/metrika»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → GET /stat/v1/data

Пример ответа · GET /stat/v1/data

API Яндекс Метрики /yandex/metrika

GET /stat/v1/data

Предоставляет доступ к статистическим данным Яндекс Метрики, включая данные, доступные в отчетах. Возвращает результат в виде таблицы.

Параметры

idsinteger[]
Идентификаторы счётчиков через запятую.
metricsstring
Список метрик через запятую. Лимит — 20 метрик в запросе.
dimensionsstring
Список группировок через запятую. Лимит — 10 группировок в запросе.
yandex.ru/dev/metrika/ru/stat/openapi/data

API отчётовверсия не подтверждена

Подключение

Подключите документацию API Яндекс Метрики к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает API Яндекс Метрики и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

  1. Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
  2. Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
  3. Спросите про API Яндекс Метрики«Найди в API Яндекс Метрики, как выгрузить сырые визиты через Logs API, и покажи ссылку на источник».
Только документация

Bridge8 не подключается к вашим счётчикам, не выгружает статистику и не загружает данные в Метрику, не выдаёт и не хранит OAuth-токены. Агент получает документацию и сам пишет код.

Claude Code — команда
claude mcp add --transport http bridge8 \ https://bridge8.ru/mcp \ --header "Authorization: Bearer <TOKEN>"
JSON для --mcp-config
{ "mcpServers": { "bridge8": { "type": "http", "url": "https://bridge8.ru/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }

Инструменты сервера — в порядке вызова

  1. resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
  2. search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
  3. 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

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 416 документов

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.