API VK Рекламы: Получить токен доступа к рекламному кабинету

Сценарий из mcp-everything. Актуально на 2026-10-24.

Первый шаг интеграции: токен для своего кабинета или для клиентов агентства.

Получи client_id и client_secret доступа к API в кабинете VK Рекламы.
Запроси токен для своего кабинета: POST /api/v2/oauth2/token.json с grant_type = client_credentials, client_id и client_secret (form-urlencoded). Для клиента агентства — grant_type = agency_client_credentials и agency_client_name или agency_client_id.
Токен живёт сутки (expires_in = 86400). Продлевай его тем же методом с grant_type = refresh_token, а не запрашивай новый: на пару «client_id + пользователь» — не больше 5 токенов одновременно, сверх лимита придёт 403.
Передавай токен в заголовке Authorization: Bearer .

curl -X POST https://ads.vk.ru/api/v2/oauth2/token.json \
  -d grant_type=client_credentials -d client_id=<client_id> -d client_secret=<client_secret>

# Продление
curl -X POST https://ads.vk.ru/api/v2/oauth2/token.json \
  -d grant_type=refresh_token -d refresh_token=<refresh_token> -d client_id=<client_id> -d client_secret=<client_secret>

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

Методы сценария

POST /api/v2/oauth2/token.json — Получение токена

В ответе: access_token, token_type, scope, expires_in, refresh_token.

Параметр	Где	Тип	Обяз.	Описание
`grant_type`	body	string	да	client_credentials, agency_client_credentials, authorization_code или refresh_token
`client_id`	body	string	да	ID клиента API
`client_secret`	body	string	нет	Секрет; нужен для client_credentials, agency_client_credentials, refresh_token
`agency_client_name`	body	string	нет	Клиент агентства/менеджера (или agency_client_id)
`agency_client_id`	body	string	нет	ID клиента агентства/менеджера
`code`	body	string	нет	Код из редиректа для authorization_code
`refresh_token`	body	string	нет	Refresh-токен для продления

Нюансы

Фильтры в списках задаются префиксом _ и суффиксами __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