API VK Рекламы: GET /api/v3/statistics/{object}/day.json — Статистика с пагинацией

Параметр	Где	Тип	Обяз.	Описание
object	path	string	да	banners, campaigns, users
date_from	query	string	да	Начало периода YYYY-MM-DD
date_to	query	string	нет	Конец периода, по умолчанию текущая дата
id	query	string	нет	ID объектов через запятую
fields	query	string	нет	Наборы метрик, по умолчанию base
attribution	query	string	нет	impression или conversion (по умолчанию)
campaign_id	query	string	нет	Фильтр по кампаниям (для статистики объявлений)
sort_by	query	string	нет	Сортировка metric.field_name
d	query	string	нет	Направление: asc (по умолчанию) или desc
limit	query	integer	нет	1–250, по умолчанию 20
offset	query	integer	нет	Смещение, по умолчанию 0

Базовые 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