API документация · /vk/ads · 280 документов

API VK Рекламы: Документация VK Ads для разработчиков: кампании, лид-формы и форматы объявлений

Ресурсы кампаний, групп и объявлений, OAuth2-токены, статистика, аудитории и лид-формы, пакеты и шаблоны баннеров MAX и лид-форм. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на ads.vk.com.

Искать в API VK Рекламы Подключить MCP

Попробуйте найти

Паспорт источника

Service ID: /vk/ads
Источник: ads.vk.com — официальная документация
Документов: 280
Состав: 280 документов · 94 ресурса · 146 объектов · 31 материал Bridge8 о пакетах и форматах
Проверка источника: 26.09.2026
Версия API: не подтверждена

ads.vk.com/doc/api

API VK Рекламы — один из 17 API в Bridge8. Тот же поиск и MCP-сервер работают для VK, Яндекса, Битрикс24, Авито и других:

Весь каталог: 25 источников →

Что включено

280 документов API VK Рекламы в одном поиске

Сохранённые копии ads.vk.com. У каждого документа — ссылка на официальную страницу и дата импорта.

Руководства
9
Авторизация OAuth2, устройство API, ошибки и лимиты, быстрый старт, статистика, добавление объявлений, ОРД для агентств, контекстный таргетинг.
- Авторизация в API
- Быстрый старт
- Статистика v2
Кампании, группы и объявления
19
Кампании, группы объявлений и баннеры, массовые действия, загрузка контента, ссылки, пакеты, площадки и шаблоны баннеров.
- AdPlans · AdPlan
- AdGroups · Banners
- Packages · PadsTree
Аудитории, цели и лид-формы
37
Сегменты и счётчики ремаркетинга, списки пользователей, локальная география, цели и события в приложениях, лид-формы, лиды и опросы.
- Segments
- LeadForms · Leads
- RemarketingCounters
Агентства, ОРД и справочники
38
Клиенты агентств и менеджеров, данные для ОРД, переводы средств, пользователь, регионы, мобильные приложения, дерево интересов, прогноз охвата.
- AgencyClients
- OrdUser
- TargetingsTree
Объекты
146
Поля и типы структур, которыми оперируют ресурсы: кампании, группы, баннеры, пакеты, сегменты, лид-формы и другие.
- AdPlan · AdGroup · Banner
- Package · Segment
- LeadForm
Пакеты и форматы: материалы Bridge8
31
15 материалов о MAX по срезу 20.10.2026 и 16 о лид-формах по срезу 26.10.2026: пакет 3215, все 14 шаблонов и заметка о трёх изображениях. Каталоговая проверка не подтверждает создание объявления. Это не страницы VK.
- Сценарии размещения MAX
- Лид-формы: пакет 3215
- Изображения 1:1, 16:9, 9:16

С чего начать

Как получить доступ к API VK Рекламы: четыре шага по документации

Коротко по страницам «Устройство API», «Авторизация в API» и «Быстрый старт» на ads.vk.com. Подробности — в поиске Bridge8 или у вашего ИИ-агента.

Получите client_id и client_secretРегистрация клиентов для работы с API через OAuth2 пока выполняется вручную — по заявке в Службу поддержки из интерфейса сервиса.
Выберите схему OAuth2Client Credentials — для своего аккаунта, Agency Client Credentials — для клиентов агентства, Authorization Code — для сторонних аккаунтов при выполнении условий.
Получите токенPOST /api/v2/oauth2/token.json с grant_type=client_credentials, client_id и client_secret. В ответе — access_token и refresh_token.
Подписывайте запросыПередавайте заголовок Authorization: Bearer {access_token}. Токен действует сутки — продлевайте его по refresh_token, а не выпускайте новый.

Лимиты токенов

Срок действия access_token: сутки (86 400 с)
Токенов на связку clientId — user: не более 5
Ответ при превышении: HTTP 403

Лимит токенов фиксирован и не увеличивается. Если он достигнут, все токены пользователя можно удалить запросом POST /api/v2/oauth2/token/delete.json.

ads.vk.com/doc/api/info/Авторизация в API

Первая кампания

Пошаговый пример — «Быстрый старт»: токен, проверка URL сообщества ВКонтакте, загрузка контента и создание кампании с группой и объявлением.

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу ads.vk.com.

Ресурсы API

7 из 94

Все 94 ресурса в поиске

Руководства и материалы о MAX

7 из 24

Все 24 страницы руководств и заметок в поиске

Как использовать

Три способа работать с документацией API VK Рекламы

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

01 · На сайте
Поиск без регистрации
Выберите API VK Рекламы в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на ads.vk.com.
API VK Рекламы · 280 → статистика по группам объявлений
02 · ИИ-агент по MCP
Спросите Claude Code или Cursor
Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.
«Напиши на Python выгрузку дневной статистики кампаний VK Рекламы за прошлую неделю с обновлением токена по refresh_token. Сверь методы с ads.vk.com»
resolve_service → search_docs → get_document
03 · Документ целиком
Читайте страницу полностью
get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.
get_document → Авторизация в API

Пример ответа · GET /api/v2/statistics/ad_plans/day.json

API VK Рекламы /vk/ads

GET /api/v2/statistics/ad_plans/day.json

Возвращает суммарную за всё время открутки или подневную за выбранный период статистику по аккаунтам, кампаниям, группам и баннерам. Статистика доступна не более чем за последние 366 дней, в одном запросе — не более чем по 200 объектам.

Параметры

date_fromYYYY-MM-DD: Начальная дата. Игнорируется для summary.json.
idсписок чисел: Идентификаторы баннеров, кампаний или рекламных планов.
metricsсписок: Наборы метрик: all, base, events, video и другие. По умолчанию — base.

ads.vk.com/doc/api/info/Statistics

Статистика v2версия не подтверждена

Подключение

Подключите документацию API VK Рекламы к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает API VK Рекламы и ещё 16 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
Спросите про API VK Рекламы«Найди в API VK Рекламы, какой пакет выбрать для рекламы канала внутри мессенджера MAX, и покажи ссылку на источник».

Получить токен

Только документация

Bridge8 не подключается к вашему рекламному кабинету, не хранит client_secret и токены и не создаёт кампании. Агент получает документацию и сам пишет код.

Claude Code — команда

claude mcp add --transport http bridge8 \
  https://bridge8.ru/mcp \
  --header "Authorization: Bearer <TOKEN>"

JSON для --mcp-config

{
  "mcpServers": {
    "bridge8": {
      "type": "http",
      "url": "https://bridge8.ru/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Инструменты сервера — в порядке вызова

resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о API VK Рекламы

Чем API VK Рекламы отличается от VK API?

API VK Рекламы (ads.vk.com) — отдельный API рекламной платформы: ресурсы кампаний, групп и объявлений с авторизацией по OAuth2. В VK API есть своя секция ads.* для рекламного кабинета ВКонтакте, например ads.getAccounts, — это другой API со своими ключами доступа.

Как получить доступ к API?

Нужны client_id и client_secret API-клиента. По документации, регистрация клиентов для работы с API через OAuth2 пока выполняется вручную — по заявке в Службу поддержки, которая доступна в интерфейсе сервиса.

Сколько живёт токен и сколько токенов можно выпустить?

Токен доступа по умолчанию действует сутки, его продлевают запросом с grant_type=refresh_token. Для связки clientId — user одновременно может существовать не более 5 токенов; лимит не увеличивается, а при его достижении запрос нового токена вернёт HTTP 403. Не вечные токены удаляются после месяца неактивности.

Как узнать текущие лимиты запросов?

Лимиты действуют на секунду, час и день. Текущие значения приходят в заголовках ответа X-RateLimit-RPS-Limit, X-RateLimit-Hourly-Limit и X-RateLimit-Daily-Limit, остаток — в заголовках *-Remaining; есть и запрос GET /api/v2/throttling.json. Превышение лимита — HTTP 429.

Какие ограничения у методов статистики?

Статистика возвращается не более чем за последние 366 дней, в одном запросе — не более чем по 200 объектам. Для больших выборок есть статистика с пагинацией: GET /api/v3/statistics/…/day.json с параметрами limit (от 1 до 250) и offset.

Как показать рекламу внутри мессенджера MAX?

По заметке Bridge8 (это не официальная страница VK): реклама внутри MAX идёт на площадке 3464710 с шаблонами баннеров 646 и 647; основные пакеты — 4822 для сайтов, 4796 и 4828 для каналов. Для продвижения канала MAX в ленте ВКонтакте — пакеты 4607 и 4686. Данные сняты в одном кабинете 20.10.2026.

Bridge8 может управлять моим рекламным кабинетом?

Нет. Bridge8 — документация для разработчиков: он не подключается к VK Рекламе от вашего имени, не выдаёт и не хранит токены, не создаёт и не меняет кампании. У каждого фрагмента — ссылка на ads.vk.com и дата импорта.

Ещё в Bridge8

Один поиск и один MCP-сервер для 17 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Другие API в Bridge8

16 API · 5 478 документов

Яндекс

8 API

VK и MAX

2 API

CRM, телефония, банк

3 API

Объявления и рассылки

3 API

Справка и курсы

8 источников

Справка Яндекс Директа, Справка Яндекс Метрики, Справка Яндекс Вебмастера, Справка Яндекс Вордстата, Справка VK Рекламы, Справка Авито Рекламы, Курсы Яндекса (ЯРД), Курсы VK Рекламы.

Каталог на главной

← На главную: поиск по всем источникам bridge8.ru/#catalog

API VK Рекламы: Документация VK Ads для разработчиков: кампании, лид-формы и форматы объявлений

280 документов API VK Рекламы в одном поиске

Руководства

Кампании, группы и объявления

Аудитории, цели и лид-формы

Агентства, ОРД и справочники

Объекты

Пакеты и форматы: материалы Bridge8