Возможности API Яндекс Метрики: Management, Reports, Logs и импорт данных

API Яндекс Метрики позволяет автоматизировать то, что обычно делают в веб-интерфейсе: создавать счётчики и цели, забирать статистику, выгружать «сырые» визиты и просмотры, загружать офлайн-конверсии и расходы. Для директолога и агентства это основа связки Метрика -> BI / CRM / Директ.

Коротко: Четыре контура API: Management (настройки), Reports / Stat (агрегаты), Logs (неагрегированные данные), Data Import (офлайн, CRM, параметры). Базовый хост: api-metrika.yandex.net, авторизация OAuth.

← Каталог: Метрика · Введение · Системы аналитики · Счётчик и код · Безопасность данных · Основы HTML/JS · Карта настройки · Типы целей · Цели · Автоцели и ecommerce · ЯТМ на практике · Тег Менеджер · Фильтры и операции · Доступы и роли · Вебвизор и карты · Карты и формы · Семплирование · Отчёты · Стандартные отчёты · Атрибуция · Сегментация · Офлайн-конверсии · ClientID и идентификаторы · Measurement Protocol · CRM и интеграции · Битрикс24 и Albato · Мессенджеры · Воронки · AppMetrica · API: введение · API: архитектура · API: окружение · API: отчёты на практике · API: Logs · DataLens · Чек-лист · Справка Яндекс Метрики

Содержание

  1. Какие API есть у Метрики
  2. API управления (Management)
  3. API отчётов (Stat / Reports)
  4. Logs API -- сырые данные
  5. API импорта данных
  6. Что API умеет / чего не заменяет
  7. Сценарии для агентства и in-house

Какие API есть у Метрики

Официально Метрика выделяет несколько API под разные задачи. Их нельзя путать: отчёты UI ? Reports API, а «все визиты построчно» -- это Logs API.

APIЗадачаТипичный URL
ManagementСчётчики, цели, фильтры, сегменты, доступыhttps://api-metrika.yandex.net/management/v1/...
Reports (Stat)Агрегированная статистика: метрики x измеренияhttps://api-metrika.yandex.net/stat/v1/data
LogsНеагрегированные hits/visits за период.../management/v1/counter/{id}/logrequests
Data ImportОфлайн-конверсии, звонки, CRM-заказы, user params, expensesметоды management / data-import

Документация: yandex.ru/dev/metrika · быстрый старт.

API управления (Management)

Через Management API можно программно:

  • получить список счётчиков GET /management/v1/counters;
  • создавать и редактировать счётчики, цели, фильтры, операции, сегменты;
  • управлять гостевыми доступами;
  • инициировать выгрузки Logs API (заявки на логи).

Пример: создание цели «мессенджер» через POST /management/v1/counter/{counterId}/goals -- тот же сценарий, что в UI, но массово для агентских аккаунтов.

Важно: Для записи нужен OAuth-доступ metrika:write и право редактирования на счётчике.

Подробнее: API управления.

API отчётов (Stat / Reports)

Reports API отдаёт агрегированные данные: измерения (dimensions) и метрики (metrics). Это аналог конструктора отчётов в интерфейсе.

Базовый метод: GET /stat/v1/data с параметрами:

  • ids -- номер счётчика;
  • metrics -- например ym:s:visits,ym:s:users,ym:s:bounceRate;
  • dimensions -- например ym:s:date,ym:s:lastTrafficSource;
  • date1 / date2, filters, limit, accuracy.

Типовые кейсы для Директа:

  • ежедневный дашборд: визиты / цели / CPA по источникам;
  • сверка конверсий Директа и Метрики;
  • выгрузка в Google Sheets / DataLens / внутренний BI.

Документация: API отчётов.

Logs API -- сырые данные

Logs API нужен, когда агрегатов недостаточно: атрибуция «как хотим», склейка с CRM, antifraud, кастомные воронки. Вы получаете строки визитов (visits) или просмотров (hits).

Асинхронный пайплайн:

  1. оценить/создать заявку logrequests;
  2. дождаться статуса готовности;
  3. скачать parts;
  4. очистить заявку (clean), чтобы не копить квоту.

Коротко: Logs != отчёты UI. Это сырьё для ClickHouse / BigQuery / своего ETL. Для обычного директолога чаще хватает Reports API + Data Import.

Документация: Logs API.

API импорта данных

Data Import закрывает обратный поток -- в Метрику:

  • офлайн-конверсии и звонки;
  • клиенты и заказы из CRM;
  • параметры посетителей (user params);
  • расходы из внешних каналов (expenses).

Именно этот контур связывает продажи из CRM с визитами и даёт Директу обучать стратегии на оплаченных заказах, а не только на заявках с сайта.

См. также инструкцию Офлайн-конверсии и API импорта данных.

Что API умеет / чего не заменяет

Можно через APIЛучше / только в UI или иначе
Массово создавать цели и фильтрыВизуальный Вебвизор и карты кликов
Забирать статистику в BI по расписаниюРучной «посмотреть один отчёт глазами»
Загружать офлайн-конверсии пакетамиРазовая ручная загрузка CSV «на глаз»
Строить свою атрибуцию на LogsЗаменить здравый смысл директолога

Связка с рекламой: API Директа описан отдельно -- каталог API Яндекс Директа.

Сценарии для агентства и in-house

  1. Ежедневный контроль целей -- Reports API -> алерт, если конверсии упали.
  2. Сквозная аналитика -- Data Import заказов + сверка с Директом.
  3. Мультиаккаунт -- Management: список счётчиков клиента, аудит целей.
  4. Data warehouse -- Logs -> ClickHouse -> свои дашборды.
  5. Расходы вне Директа -- expenses API, чтобы в Метрике был полный CPA.

Чек-лист: какие API подключить

  1. Определить задачу: настройки / агрегаты / сырые логи / импорт офлайна
  2. Выписать нужные OAuth-скоупы (read / write / offline_data / expenses)
  3. Проверить доступ владельца токена к счётчику
  4. Для Директа запланировать связку Reports + Data Import, а не только UI

Комментарий эксперта

Константин Горбунов

Константин Горбунов
Основатель Monster Context и AdPump, эксперт Яндекса по обучению. Работает с Яндекс Метрикой и Директом с 2011 года.

В Monster Context API Метрики чаще всего нужен не «ради API», а чтобы офлайн-продажи и цели стабильно доезжали до Директа. Reports -- для контроля, Data Import -- для денег, Logs -- только на зрелых проектах.

Частые вопросы

Нужен ли отдельный API для Вебвизора?
Записи Вебвизора смотрят в интерфейсе; API ориентирован на настройки, статистику, логи и импорт данных.

Можно ли заменить Мастер отчётов Директа API Метрики?
Нет: расходы и аукционные метрики Директа -- в API Директа; поведение на сайте и цели -- в API Метрики. Их комбинируют.

С чего начать новичку?
OAuth с metrika:read -> Reports API один простой отчёт -> затем Management для целей. Logs -- только когда понадобится сырьё.

Начните с введения в API Метрики, дальше -- архитектура API и взаимодействие. Практика офлайна: Офлайн-конверсии. Документация: API Метрики.

Материал подготовлен редакцией AdPump совместно со специалистами Monster Context (m-context.ru) на основе практики ведения аккаунтов Яндекс Директа и обновлений Яндекс Метрики 2026 года.

← Каталог: Метрика · Введение · Системы аналитики · Счётчик и код · Безопасность данных · Основы HTML/JS · Карта настройки · Типы целей · Цели · Автоцели и ecommerce · ЯТМ на практике · Тег Менеджер · Фильтры и операции · Доступы и роли · Вебвизор и карты · Карты и формы · Семплирование · Отчёты · Стандартные отчёты · Атрибуция · Сегментация · Офлайн-конверсии · ClientID и идентификаторы · Measurement Protocol · CRM и интеграции · Битрикс24 и Albato · Мессенджеры · Воронки · AppMetrica · API: введение · API: архитектура · API: окружение · API: отчёты на практике · API: Logs · DataLens · Чек-лист

Перейти в инструмент