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

API открывает доступ к программной работе с основными функциями рекламного кабинета Авито.

Каждый аккаунт имеет лимит на использование API — он выражается в баллах. Баллы расходуются при передаче данных по API. Разные методы API расходуют различное количество баллов: увидеть точное значение можно в ответе сервера.

Текущий баланс баллов отображается в разделе Аккаунт → API. Этот баланс общий для всех ключей.

Когда баллы закончатся, запросы в API перестанут обрабатываться. Баланс баллов восстанавливается автоматически каждую неделю — в понедельник в полночь по Гринвичу (UTC+0).

Помимо баланса баллов, каждый метод API имеет независимое ограничение на частоту использования. Если запросы к одному методу поступают слишком часто, API будет их отклонять — даже если на балансе достаточно баллов. Эти ограничения указаны в технической документации каждого метода.

Доступ к API есть у всех аккаунтов Авито Рекламы. Для создания ключа API требуется роль Администратора в аккаунте.

Как подключить:

1. Войдите в рекламный кабинет Авито Рекламы.
2. Перейдите в настройки аккаунта.
3. Найдите раздел API и создайте новый ключ. При создании укажите произвольное имя ключа — оно поможет идентифицировать его в будущем.
4. Сохраните Client Key и Client Secret — они отображаются только в момент создания и не могут быть восстановлены. Если ключ утерян, создайте новый.

Внутри контейнера отступы:

1. справа 24рх
2. слева 24рх
3. сверху 24рх
4. снизу 28 рх

изображение всегда в центре серой области

Важно знать о ключах:

• Каждый ключ предоставляет полный доступ ко всем доступным методам публичного API.
• Если ключ нужно удалить, обратитесь в поддержку, указав ID аккаунта и название ключа.
• Все ключи дают доступ к тестовой среде (песочнице), где можно проверить интеграцию без влияния на реальные кампании.

Тестовая среда (песочница)

В песочнице доступны тестовые данные для проверки методов чтения и изменения данных. Это позволяет разработчику убедиться, что интеграция настроена правильно до перехода к работе с настоящими данными.

Чтобы получить доступ в тестовую среду, создайте специальный тестовый аккаунт при помощи API, в котором будут доступны данные для тестирования и отладки (например, статистика).

В песочнице можно создать дочерний аккаунт, но войти в него не получится — для аккаунтов, созданных в тестовой среде, нельзя сгенерировать токен доступа. Создание дочернего аккаунта можно проверить через метод получения списка дочерних аккаунтов.

Подробное описание всех методов API с примерами запросов и ответов доступно на портале для разработчиков.

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

Если возникли вопросы по работе с API, обратитесь в службу поддержки Авито Реклама. Чтобы вопрос был решён быстрее, укажите в обращении:

• Задачу — что именно вы пытаетесь сделать.
• Ожидаемый результат — какой ответ или действие API вы ожидаете.
• Пример запроса в формате curl — так специалист поддержки сможет быстрее разобраться и подсказать, что нужно исправить в запросе.

Если вы нашли ошибку в документации или вам не хватает функций API, пройдите опрос. Мы учтём ваше пожелание при планировании развития API Авито Рекламы.