Что это
API Яндекс Директа помогает связать рекламный кабинет с отчетом, учетной системой или вашим помощником. Он работает с кампаниями, объявлениями, ключевыми фразами и другими ресурсами; статистика запрашивается по правилам сервиса отчетов.
Сам API не анализирует эффективность как языковая модель. Расчет показателей и объяснение причин готовятся отдельно. Автоматическое изменение ставки или запуск объявления влияет на реальные деньги, поэтому рекомендации и применение изменений должны быть разными этапами.
Начните в Sandbox. Песочница использует тестовые кампании и не расходует рабочий рекламный бюджет. Ее статистика учебная: по ней нельзя оценить реальную прибыльность кампании.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Один рабочий день
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Можно запрашивать только необходимые поля, например ID и название кампании.
- Sandbox отделяет учебные действия от реальных показов и бюджета.
- API позволяет строить повторяемые отчеты без ручного копирования.
- Units и RequestId помогают контролировать нагрузку и разбирать ошибки.
Ограничения
- Для собственного приложения нужны OAuth и оформление доступа по правилам Директа.
- Лимит баллов и одновременных запросов ограничивает частоту обмена.
- Версия API и тип кампании влияют на маршрут и доступные поля.
- Корректность метрик, выводы ИИ и согласование расходов реализуются отдельно.
Как использовать
1. Подготовка. Зарегистрируйте свое приложение в Яндекс OAuth и оформите нужный доступ по инструкции Директа. В разделе API включите Sandbox, выберите роль клиента и создание тестовых кампаний. Не пополняйте реальный бюджет для этого теста.
2. Настройка. Получите OAuth-токен и храните его в защищенной переменной. Для песочницы используйте адрес api-sandbox.direct.yandex.com; для агентского подключения отдельно проверьте Client-Login. Добавьте Authorization: Bearer <токен>, Accept-Language: ru и Content-Type: application/json.
3. Первый результат. Выполните POST https://api-sandbox.direct.yandex.com/json/v5/campaigns с JSON: {"method":"get","params":{"SelectionCriteria":{},"FieldNames":["Id","Name"]}}. Прочитайте result.Campaigns и составьте список учебных кампаний. get здесь читает данные, несмотря на HTTP POST.
4. Проверка. Убедитесь, что запрос ушел в Sandbox, а не в рабочий API. Проверьте HTTP-статус и поле error, сохраните RequestId без токена. LimitedBy означает неполную выдачу, Units - расход баллов, не рублей. Для рабочих ЕПК сверяйте маршрут v501 и поддерживаемые поля по текущему справочнику.
Примеры сценариев
- Собрать учебный список кампаний без показа рекламы.
- Выявить неполную выгрузку перед построением отчета.
- Подготовить рекомендации без изменения ставок.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Да
- VPN: Не нужен
- Русский интерфейс: Да
- Русский язык: Не известно
Sandbox - тестовая среда, не бесплатная рабочая рекламная кампания. Рабочие расходы на рекламу и инфраструктуру отдельные. Баллы API регулируют нагрузку; их нельзя считать балансом в рублях. Готовые программы и собственные приложения имеют разные процедуры получения доступа.
Когда не подходит
- Автоматически тратить бюджет по совету модели
- Оценить реальную окупаемость по данным Sandbox
- Получить доступ к чужому кабинету без разрешения
Альтернативы
Google Ads API и Meta Marketing API работают с другими рекламными системами. Wordstat API дает сведения о спросе, но не управляет кампаниями Директа и не заменяет их статистику.
