AdPump — API Яндекс Метрики: введение для тех, кто раньше работал только с интерфейсом

Перед тем как переходить к возможностям и архитектуре API, разбираем базовый вопрос: что такое API Метрики в принципе, зачем он директологу, и когда хватает обычного интерфейса без единой строчки кода.

Коротко: API Метрики — это способ получать те же данные, что видны в интерфейсе, программно: через запросы, а не через клики по отчётам. Это нужно, когда данные нужны регулярно, в большом объёме или в связке с другими источниками (расходы из Директа, данные CRM) — то есть там, где вручную выгружать неудобно.

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

Содержание

Что такое API в двух словах
Когда API реально нужен
Два главных API: Reports и Logs
Базовая идея авторизации
Куда двигаться дальше

Что такое API в двух словах

API (application programming interface) — это способ одной программе запросить данные у другой по чётким правилам, без участия человека, кликающего по кнопкам. Для Метрики это означает: вместо того чтобы открывать отчёт в браузере и вручную выгружать таблицу, программа отправляет запрос и получает те же данные в структурированном виде (обычно JSON или CSV) напрямую.

Когда API реально нужен

Нужно объединить данные Метрики с данными из других систем (расходы по кампаниям, данные CRM) в одном отчёте или дашборде — вручную сверять таблицы каждую неделю неудобно.
Объём данных или частота обновления такие, что интерфейс становится медленным или неудобным (например, ежедневная выгрузка по сотням кампаний).
Нужна автоматическая загрузка данных обратно в Метрику — например, регулярная загрузка офлайн-конверсий из CRM по расписанию, а не руками раз в месяц.

Коротко: Если задача — посмотреть отчёт пару раз в неделю и сравнить с прошлым периодом, обычно быстрее и дешевле использовать сам интерфейс Метрики, а не разрабатывать интеграцию с API.

Два главных API: Reports и Logs

У Метрики два основных API для получения данных: Reports API (Stat API) — аналог обычных отчётов, отдаёт агрегированные данные (сколько визитов, конверсий за период по нужным срезам); и Logs API — отдаёт необработанные данные по каждому визиту или просмотру отдельно, без агрегации. Подробнее про то, какой выбрать под задачу и как устроена архитектура решения — в статьях Возможности API и Архитектура API.

Базовая идея авторизации

Доступ к API выдаётся через OAuth-токен, привязанный к аккаунту с правами на конкретный счётчик -- то есть теми же правами доступа, что и в обычном интерфейсе. Токен передаётся в каждом запросе к API и определяет, какие счётчики и данные доступны программе.

Куда двигаться дальше

После знакомства с самой идеей API логичный порядок: сначала прочитать про конкретные возможности и лимиты, потом про архитектуру типового решения, затем выбрать среду разработки (см. Выбор окружения) и перейти к практическим запросам (Reports API на практике и Logs API).

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

Екатерина Марченкова
Руководитель отдела по работе с клиентами Monster Context. Работает с аналитикой рекламных кабинетов с 2012 года.

Директологу не нужно самому писать код для API — но полезно понимать, что там происходит, чтобы формулировать задачу разработчику точно: какие метрики, какая частота обновления, куда складывать результат.

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

Нужно ли уметь программировать, чтобы пользоваться API Метрики?
Да, базовое понимание того, как отправляются HTTP-запросы и обрабатываются ответы в выбранном языке программирования, потребуется — это не встроенный инструмент интерфейса без кода.

API Метрики платный?
Сам доступ к API бесплатен в рамках обычных лимитов запросов; расходы, если они возникают, связаны с инфраструктурой для хранения и обработки данных (сервер, БД), а не с самим API.

Можно ли через API изменить настройки счётчика, а не только читать данные?
Да, помимо чтения статистики есть Management API для управления настройками счётчика (цели, фильтры, доступы) программно.

Далее: Возможности API, Архитектура API.

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

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