AdPump — Версии API Яндекс Директа: v4, Live 4 и актуальный v5 JSON

Сравнение версий API Яндекс Директа: Live 4, API v4 и актуальный v5.

Коротко: Для новых интеграций — только API v5 (JSON). v4 и Live 4 устарели.

← Каталог API Директа · Введение · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Ошибки · Автоматизация · Документация Яндекса

Содержание

Сравнительная таблица
API v5
Устаревшие
Миграция

Live 4 vs API v4 vs API v5

Параметр	Live 4 (SOAP)	API v4 (SOAP)	API v5 (JSON)
Протокол	SOAP/XML	SOAP/XML	HTTPS + JSON
Endpoint	api.direct.yandex.com/live/v4	api.direct.yandex.com/v4/json	https://api.direct.yandex.com/json/v5/{service}
Статус	Устарел	Устарел	Актуален
Авторизация	OAuth / токен	OAuth	OAuth 2.0 Bearer
Отчёты	В составе API	Отдельный endpoint	https://api.direct.yandex.com/json/v5/reports
ЕПК / Unified	Нет	Ограниченно	Полная поддержка
Песочница	Нет	Нет	https://api-sandbox.direct.yandex.com/json/v5
Рекомендация	Не использовать	Не использовать	Единственный выбор

Live 4 — первое SOAP-API Директа. API v4 — улучшенная SOAP-версия с JSON-обёрткой. С 2018 года рекомендованная версия — v5 с разделением на сервисы.

API v5 — текущий стандарт

POST https://api.direct.yandex.com/json/v5/campaigns

Content-Type: application/json; charset=utf-8

Authorization: Bearer <access_token>

Accept-Language: ru

{

  "method": "get",

  "params": {

    "SelectionCriteria": {"States": ["ON"]},

    "FieldNames": ["Id", "Name", "State", "Status", "Type"]

  }

}

Ключевые преимущества v5:

Единый формат JSON для всех сервисов.
Чёткая структура: method + params в теле запроса.
Поддержка ЕПК, автостратегий, общих наборов минус-фраз.
Песочница для безопасного тестирования.

Полный список сервисов v5.

Устаревшие Live 4 и API v4

Важно! Не создавайте новые приложения на v4 или Live 4. Яндекс может отключить устаревшие endpoint без предупреждения.

Устаревшие методы и отличия:

BidModifiers.toggle — удалён в v5, используйте bidmodifiers.set / delete.
AgencyClients.add — создание клиентов только через кабинет.
SOAP-методы Live 4 не поддерживают ЕПК, UnifiedCampaign и новые типы объявлений.
Формат ответов и коды ошибок отличаются от v5.

API v4 (архив) · Обзор API v5.

Миграция с v4 на v5

Рекомендуемый порядок миграции:

Замените endpoint на api.direct.yandex.com/json/v5/{service}.
Перепишите SOAP/XML на JSON с полями method и params.
Обновите обработку ошибок — в v5 другая структура error.error_code.
Протестируйте в песочнице, затем переключитесь на боевой URL.
Проверьте лимиты баллов — в v5 другая стоимость запросов.

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