API VK Рекламы: GET /api/v2/ad_plans.json — Список кампаний

Параметр	Где	Тип	Обяз.	Описание
limit	query	integer	нет	Число кампаний, по умолчанию 20
offset	query	integer	нет	Смещение
_id	query	integer	нет	Фильтр по ID; несколько — _id__in=6617841,6711647
_status	query	string	нет	active, blocked, deleted; также _status__ne, _status__in
sorting	query	string	нет	id, name, status; минус — по убыванию, например -id

Пример ответа:

{
    "count": 3,
    "offset": 0,
    "items": [
        {
            "id": 6617841,
            "name": "New campaign 2022-07-15 17:53"
        },
        {
            "id": 6711647,
            "name": "New campaign 2022-08-16 19:49"
        },
        {
            "id": 6711665,
            "name": "New campaign 2022-08-16 19:51"
        }
    ]
}

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