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

VK API: Документация методов ВКонтакте для людей и ИИ-агентов

Методы ВКонтакте по секциям, ключи доступа пользователя, сообщества и сервисный, Callback API и Bots Long Poll, коды ошибок и лимиты вызовов. Ищите на сайте или подключите MCP-сервер к Claude Code и Cursor — каждый ответ со ссылкой на dev.vk.ru.

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

Service ID
/vk/social
Источник
dev.vk.ru — официальная документация
Документов
577
Состав
545 страниц dev.vk.ru · 464 метода · 32 материала Bridge8
Проверка источника
20.10.2026
Версия API
не подтверждена
dev.vk.ru/ru/api/overview

Что включено

577 документов VK API в одном поиске

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

  • Руководства и ключи доступа

    30

    Обзор и быстрый старт, ключи доступа пользователя, сообщества и сервисный, формат запросов, Callback API, Long Poll, загрузка файлов, хранимые процедуры.

    • Ключи доступа: общие сведения
    • Callback API
    • Bots Long Poll API
  • Справочники, объекты и ошибки

    51

    Объекты API, права доступа, история версий, JSON Schema и коды ошибок с рекомендациями, что делать.

    • Коды ошибок
    • Права доступа
    • Вложения записей на стене
  • Методы: сообщества, стена, сообщения, медиа

    274

    Секции messages, groups, photos, video, wall, stories, friends, users и ещё 18 — от публикации записей и переписки до загрузки фото и видео.

    • wall.get · wall.post
    • messages.send
    • groups.getLongPollServer
  • Методы: реклама, магазин, приложения

    190

    Рекламный кабинет ВКонтакте (ads), товары (market), приложения и виджеты, secure, заказы, лид-формы, VK Donut и другие платформенные секции.

    • ads.getAccounts
    • market.add
    • leadForms.create
  • Материалы Bridge8

    32

    Заметки о wall.get и execute и 30 карточек по JSON Schema VKCOM: методы без страниц на dev.vk.ru и расхождения параметров. Это не страницы VK.

    • owner_id в wall.get
    • execute и VKScript
    • Расхождения схемы: wall

С чего начать

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

Коротко по официальным страницам dev.vk.ru «Быстрый старт» и «Ключи доступа». Подробности каждого шага — в поиске Bridge8 или у вашего ИИ-агента.

  1. Выберите тип ключаКлюч пользователя, сообщества или сервисный. В верхней части страницы каждого метода указано, какой ключ подходит для вызова.
  2. Зарегистрируйте приложениеИгру или мини-приложение — в панели управления dev.vk.com, Standalone-приложение — в кабинете сервиса авторизации VK ID.
  3. Получите ключКлюч сообщества: «Управление» → «Дополнительно» → «Работа с API» → «Ключи доступа» → «Создать ключ». Ключ пользователя — через VK ID SDK или HTTP-запрос.
  4. Выполните запросПередайте ключ в заголовке Authorization: Bearer <КЛЮЧ_ДОСТУПА> и обязательный параметр v — версию API. Адрес сервера — api.vk.ru.

Срок действия ключей

Ключ пользователя
1 час
Ключ сообщества
не ограничен
Сервисный ключ
не ограничен

Ключ сообщества может получить только администратор сообщества. Сервисный ключ используйте только на сервере. Implicit Flow и Authorization Code Flow для ключа пользователя отключены с 25 июня 2024 года.

dev.vk.ru/ru/api/access-token/getting-started
Лимиты с 7 сентября 2026 года

На аккаунт в Кабинете для бизнеса VK ID — 10 000 вызовов в месяц без верификации бизнес-профиля и 100 000 000 после неё (страница «Обзор» на dev.vk.ru).

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

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

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

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

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

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

  1. 01 · На сайте

    Поиск без регистрации

    Выберите VK API в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на dev.vk.ru.

    VK API · 577 → ключ доступа сообщества
  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Напиши на Python бота сообщества ВКонтакте на Bots Long Poll API: ответ на новое сообщение через messages.send. Сверь методы с dev.vk.ru»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → messages.send

Пример ответа · messages.send

VK API /vk/social

messages.send

Отправляет сообщение. Вызывается с ключом доступа сообщества с правом messages. Обязательный random_id защищает от повторной отправки одного и того же сообщения.

Параметры

user_idinteger
Идентификатор пользователя, которому отправляется сообщение. Вместо него можно использовать peer_id.
random_idinteger
Уникальный идентификатор для предотвращения повторной отправки; 0 — проверка не нужна.
messagestring
Текст личного сообщения, до 9000 символов. Обязателен, если не задан attachment.
dev.vk.ru/ru/method/messages.send

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

Подключение

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

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

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

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

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

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>" } } } }

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

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

Вопросы

Вопросы о VK API

Что такое VK API?

Набор методов для работы с объектами экосистемы VK: каждый метод получает, создаёт, изменяет или удаляет данные. Методы сгруппированы по секциям — wall, messages, groups, photos и другие. При успешном вызове API возвращает JSON с результатом, при ошибке — JSON с описанием ошибки.

Какие бывают ключи доступа и сколько они действуют?

Ключ пользователя — запросы от имени пользователя, действует 1 час. Ключ сообщества — от имени сообщества или публичной страницы, срок не ограничен, получить его может только администратор. Сервисный ключ — от имени приложения, срок не ограничен, используется только на сервере.

Как получить ключ доступа сообщества?

В сообществе, где вы администратор: «Управление» → «Дополнительно» → «Работа с API» → вкладка «Ключи доступа» → «Создать ключ». Выберите права и подтвердите действие в приложении ВКонтакте или по СМС. Программно ключ получают через OAuth ВКонтакте — сначала groups.get с filter=admin.

Какую версию API указывать в параметре v?

Параметр v обязателен в каждом запросе и влияет на формат ответов. В документах корпуса номера расходятся: страница «Формат запросов» и история версий называют разные версии. Сверяйте номер на dev.vk.ru — в Bridge8 версия API не подтверждена.

Какие лимиты у VK API?

По частоте: ключ пользователя — 3 запроса в секунду, ключ сообщества — 20, сервисный — от 5 до 60 в зависимости от числа пользователей приложения. С 7 сентября 2026 года действуют и месячные лимиты на аккаунт VK ID: 10 000 вызовов без верификации бизнес-профиля и 100 000 000 после неё.

Что делать при ошибках 6 и 9?

Ошибка 6 — «Слишком много запросов в секунду»: задайте больший интервал между вызовами или используйте метод execute. Ошибка 9 — «Слишком много однотипных действий»: сократите число однотипных обращений, например через execute.

Callback API или Bots Long Poll?

В Callback API ВКонтакте сам отправляет события на ваш сервер, а сервер отвечает строкой ok со статусом HTTP 200; к сообществу можно подключить до 10 серверов. В Bots Long Poll очередь событий хранится на стороне ВКонтакте: сессию получают методом groups.getLongPollServer, затем опрашивают сервер.

Bridge8 может получить токен или войти в мой аккаунт?

Нет. Bridge8 хранит копию официальной документации dev.vk.ru для поиска и ИИ-агентов: он не выдаёт и не хранит ключи доступа, не входит в аккаунты и не управляет сообществами. У каждого фрагмента — ссылка на первоисточник и дата импорта.

Ещё в Bridge8

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

Другие API в Bridge8

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

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

8 источников

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

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

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.