Просмотры и лимиты

Просмотры

API тратит тот же баланс просмотров, что и дашборд, и по тем же правилам. Платят только маршруты, которые отдают новые карточки креативов.

Запрос	Стоимость
Поиск, где найдено до 1 000 креативов	1 просмотр за каждую карточку на странице
Поиск, где найдено больше 1 000 креативов	1 просмотр за каждые 8 карточек
Та же страница повторно в течение 2 часов	бесплатно
Детали креатива, перезаливы, приложения, папки, аккаунт	бесплатно

Правила поиска действуют и для похожих креативов и рекламы приложения.

Каждый платный ответ показывает расход:

• meta.views_charged — сколько стоила эта страница;
• meta.page_cached — страница уже была оплачена в последние 2 часа;
• usage.views_remaining — остаток после запроса, null на безлимите.

Совет

Широкий запрос, где найдено больше 1 000 креативов, стоит в 8 раз меньше за карточку. Для мониторинга выгоднее брать большие страницы по широкому запросу и досеивать результат у себя.

Когда просмотры закончились

Страница, на которой баланс дошёл до нуля, отдаётся полностью, а в meta.exhausted будет true. Дальше карточки приходят с locked: true и без ссылок на медиа, а meta.locked становится true. Пополнить баланс можно в тарифах.

Частота запросов

Не больше 120 запросов в минуту на ключ и IP-адрес. При превышении API отвечает 429 с кодом RATE_LIMIT, а поле error.retry_at показывает, когда можно продолжить: unix-время или дату в формате YYYY-MM-DD HH:MM:SS, если ключ временно заблокирован.

{ "error": { "code": "RATE_LIMIT", "message": "API rate limit exceeded: 120 requests per minute.", "retry_at": 1790000060 } }