API документация · /yandex/direct · 235 документов

API Яндекс Директа: Документация API v5 для разработчиков: сервисы, отчёты Reports и OAuth-токен

Сервисы и методы API v5 для кампаний, объявлений, фраз и ставок, статистика через сервис Reports, OAuth-токен, баллы и коды ошибок, примеры на cURL, PHP и Python. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на yandex.ru/dev/direct.

Искать в API Яндекс Директа Подключить MCP

Попробуйте найти

Паспорт источника

Service ID: /yandex/direct
Источник: yandex.ru — официальная документация
Документов: 235
Состав: 235 страниц · 26 сервисов API v5 · 18 страниц о Reports · 18 примеров кода
Проверка источника: 26.09.2026
Версия API: не подтверждена

yandex.ru/dev/direct/doc/ru

API Яндекс Директа — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

235 документов API Яндекс Директа в одном поиске

Сохранённые копии yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

Справочник методов
126
26 сервисов: кампании, группы, объявления, фразы, ставки и корректировки, стратегии, ретаргетинг, фиды, справочники, клиенты агентств.
- Campaigns.get
- Ads.add
- Keywords.add
Объекты и приложения
27
Описание кампаний, объявлений, фраз и других объектов, роли и доступы пользователей, типы стратегий и настройки кампаний.
- Кампания (Campaign)
- Ключевая фраза (Keyword)
- Типы стратегий
Руководство разработчика
30
Доступ и регистрация приложения, токены, форматы JSON и SOAP, HTTP-заголовки, баллы и ошибки; лучшие практики и решение проблем.
- Авторизационные токены
- Ограничения, баллы
- Ошибки и предупреждения
Сервис Reports
18
Статистика по аккаунту: спецификация отчёта, типы, поля и фильтры, онлайн- и офлайн-режим, коды ответов, примеры с данными Метрики.
- Как сформировать отчет
- Запрос: спецификация отчета
- Онлайн- и офлайн-отчет
Примеры кода
18
Запросы на cURL, PHP и Python: получение токена и кампаний, ставки, стратегии, временной таргетинг, статистика.
- Получение токена на Python
- Назначение ставок на cURL
- Статистика клиентов агентства
Курс и общие страницы
16
Курс «Как начать работу с API»: от регистрации приложения до первого запроса и ограничений. История изменений API v5 и обновления кампаний.
- Урок 2. Регистрация приложения
- Урок 4. Как получить OAuth-токен
- История изменений

С чего начать

Как начать работу с API Директа: пять шагов по документации

Коротко по курсу «Как начать работу с API» и разделу «Регистрация приложения» на yandex.ru/dev/direct. Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

Создайте аккаунт в ДиректеВ веб-интерфейсе Директа выберите страну и валюту, затем на странице «Настройки API» нажмите «Получить доступ к API» и примите пользовательское соглашение.
Зарегистрируйте приложениеВ Яндекс ID выберите «Для доступа к API или отладки» и добавьте доступ direct:api. Сохраните ClientID — он нужен для заявки и для получения токена.
Подайте заявку на доступ«Настройки API» → «Мои заявки» → «Новая заявка»: выберите ClientID и опишите приложение. Без одобренной заявки запросы к API не выполняются.
Получите OAuth-токенДля отладки — вручную по ссылке oauth.yandex.ru/authorize?response_type=token&client_id=…; для реальных пользователей — автоматически, через страницу запроса доступа.
Выполните первый запросPOST на https://api.direct.yandex.com/json/v501/campaigns с заголовком Authorization: Bearer и методом get — так урок курса получает список кампаний.

Заявка на доступ

Кто подаёт: Только разработчик приложения
Сколько заявок: Одна на ClientID
Рассмотрение: От часа до трёх суток в рабочие дни, в пик — до семи

Пользователям приложения регистрироваться не нужно: после одобрения заявки с приложением может работать неограниченное число пользователей.

yandex.ru/dev/direct/doc/ru/access-request

Нет страницы «Настройки API»?

По разделу «Регистрация приложения», чтобы открыть настройки API, нужно создать хотя бы одну кампанию в веб-интерфейсе Директ Про.

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

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

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

Сервисы и методы API v5

7 из 126

Все 126 страниц справочника в поиске

Руководства

7 из 235

Все 235 страниц документации в поиске

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

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

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

01 · На сайте
Поиск без регистрации
Выберите API Яндекс Директа в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.
API Яндекс Директа · 235 → OAuth-токен для API Директа
02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на Python выгрузку кликов и расходов через сервис Reports API Директа с обработкой кодов 201 и 202. Сверь параметры с yandex.ru/dev/direct»
resolve_service → search_docs → get_document
03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → Campaigns.get

Пример ответа · Campaigns.get

API Яндекс Директа /yandex/direct

Campaigns.get

Возвращает параметры кампаний, отвечающих заданным критериям. Метод возвращает не более 10 000 объектов.

Параметры

SelectionCriteriaCampaignsSelectionCriteria: Критерий отбора кампаний. Чтобы получить все кампании пользователя, укажите пустой SelectionCriteria.
FieldNamesarray of CampaignFieldEnum: Имена параметров, общих для всех типов кампаний, которые требуется получить.
PageLimitOffset: Страница при постраничной выборке данных.

yandex.ru/dev/direct/doc/ru/campaigns/get

API v5 · JSON и SOAPверсия не подтверждена

Подключение

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

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

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

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

Получить токен

Только документация

Bridge8 не подключается к вашему кабинету Директа, не меняет кампании и ставки, не выдаёт и не хранит OAuth-токены. Это MCP-сервер с документацией: агент читает её и сам пишет код.

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>"
      }
    }
  }
}

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

resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о API Яндекс Директа

Что такое API Яндекс Директа?

Программный интерфейс для автоматизированного управления кампаниями: приложения добавляют и редактируют кампании, объявления и ключевые фразы, задают ставки, получают статистику. API состоит из веб-сервисов — например, Campaigns или Ads; запросы отправляются по HTTPS методом POST в формате JSON или SOAP.

Платный ли доступ к API Директа?

Нет: «Подключение к API Директа и его использование является бесплатным». Запросы выполняются от имени пользователей Директа, авторизация — по протоколу OAuth 2.0. Нагрузку регулируют баллы: суточный лимит зависит от активности кампаний.

Как получить OAuth-токен?

Зарегистрируйте приложение в Яндекс ID с доступом direct:api и получите ClientID. Для отладки токен можно получить вручную по ссылке oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>. Токен передают в каждом запросе в заголовке Authorization: Bearer.

Сколько запросов можно отправлять?

Не более пяти одновременных запросов от одного рекламодателя. Остаток баллов виден в заголовке ответа Units: «израсходовано / доступный остаток / суточный лимит», например 10/20828/64000. За ошибку вызова метода списывается 20 баллов.

Как получить статистику через Reports?

Отправьте POST-запрос к сервису Reports с параметрами отчёта. Небольшой отчёт приходит сразу с кодом 200. Большой формируется офлайн: код 201 или 202 — повторите запрос с теми же параметрами позже. Лимиты — 20 запросов за 10 секунд и не более 5 офлайн-отчётов в очереди на пользователя.

Нужен ли API v4?

Для большинства задач — нет: документация описывает API версии 5. Но общий счёт по-прежнему ведут методы v4 или Live 4 — так сказано в разделе «Общий счет (SharedAccount)». Что ещё работает в v4 — на странице API Директа v4.

Это официальный сайт Яндекса?

Нет. Bridge8 хранит копию официальной документации yandex.ru/dev/direct для поиска и ИИ-агентов. У каждого фрагмента — ссылка на первоисточник и дата импорта; версия API не подтверждена.

Bridge8 может управлять моими кампаниями?

Нет. Bridge8 — документация для разработчиков: он не подключается к Директу от вашего имени, не создаёт кампании и не меняет ставки, не выдаёт и не хранит токены. Код по документации пишет ваш агент, а запросы выполняет ваше приложение.

Ещё в Bridge8

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

Другие API в Bridge8

16 API · 5 523 документа

Яндекс

7 API

VK и MAX

3 API

CRM, телефония, банк

3 API

Объявления и рассылки

3 API

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

8 источников

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

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

← На главную: поиск по всем источникам bridge8.ru/#catalog

API Яндекс Директа: Документация API v5 для разработчиков: сервисы, отчёты Reports и OAuth-токен

235 документов API Яндекс Директа в одном поиске

Справочник методов

Объекты и приложения

Руководство разработчика

Сервис Reports

Примеры кода

Курс и общие страницы

Как начать работу с API Директа: пять шагов по документации

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

Сервисы и методы API v5

Руководства

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

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

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

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

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

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

Вопросы о API Яндекс Директа

Что такое API Яндекс Директа?

Платный ли доступ к API Директа?

Как получить OAuth-токен?

Сколько запросов можно отправлять?

Как получить статистику через Reports?

Нужен ли API v4?

Это официальный сайт Яндекса?

Bridge8 может управлять моими кампаниями?

Связанные источники и все API

Другие API в Bridge8

Яндекс

VK и MAX

CRM, телефония, банк

Объявления и рассылки

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

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