API VK Рекламы: GET /api/v2/statistics/{object}/{period}.json — Статистика

object — banners, campaigns или users; period — day или summary.

В ответе: items[] (id, rows по датам, total) и общий total.

Параметр	Где	Тип	Обяз.	Описание
object	path	string	да	banners, campaigns, users
period	path	string	да	day или summary
id	query	string	да	ID объектов через запятую, до 200
date_from	query	string	нет	Начало периода YYYY-MM-DD (обязателен для day)
date_to	query	string	нет	Конец периода включительно (обязателен для day)
metrics	query	string	нет	all, base (по умолчанию), events, video, uniques, tps, playable, romi
attribution	query	string	нет	Модель атрибуции impression; для summary игнорируется

Базовые URL

• Боевой: https://ads.vk.ru
• Методы: /api/v2/

Авторизация

Тип: OAuth 2.0

Токен получают методом POST /api/v2/oauth2/token.json (application/x-www-form-urlencoded) и передают в заголовке:

Токен живёт сутки (expires_in = 86400) и продлевается через refresh_token. На пару «client_id + пользователь» — не больше 5 токенов одновременно; запрос сверх лимита возвращает HTTP 403.

Authorization: Bearer {access_token}

Нюансы

• Фильтры в списках задаются префиксом _ и суффиксами __in, __ne, __lt, __lte, __gt, __gte.
• ad_groups нельзя запрашивать через fields в списке кампаний.
• Посуточная статистика доступна не больше чем за последние 365 дней.
• Временные токены удаляются автоматически после месяца без использования.
• Есть отдельные эндпоинты статистики по целям (/api/v2/statistics/goals/...), in-app событиям (/api/v2/statistics/inapp/...) и офлайн-конверсиям.
• Для агентств и менеджеров — ресурсы AgencyClients и ManagerClients и токен с grant_type=agency_client_credentials.

Сценарии с этим методом

• Выгрузить статистику кампаний по дням

---

Если этого недостаточно — официальная документация: https://ads.vk.ru/en/doc/api/info/Authorization Вся интеграция одним документом: https://mcp-everything.ru/integrations/vk-ads.md