VK API: Узнать данные пользователя или сообщества по ссылке

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

По ссылке vk.com/durov или vk.com/club1 получить ID и профиль — для привязки аккаунта, CRM или проверки.

1. Получи тип и ID объекта по короткому имени: POST /method/utils.resolveScreenName с screen_name (часть ссылки после vk.com/). В ответе type (user, group, application) и object_id.
2. Для пользователя запроси профиль: POST /method/users.get с user_ids и fields — нужными полями (screen_name, city, photo_100, last_seen и др.).
3. Для сообщества — POST /method/groups.getById с group_id.
4. Для таких запросов подходит сервисный ключ приложения — не нужно просить пользователя об авторизации. Профиль может быть приватным — ошибка 30.

curl https://api.vk.ru/method/utils.resolveScreenName -H "Authorization: Bearer $VK_SERVICE_TOKEN" \
  -d screen_name=durov -d v=5.199

curl https://api.vk.ru/method/users.get -H "Authorization: Bearer $VK_SERVICE_TOKEN" \
  -d user_ids=1 -d fields=screen_name,city,photo_100 -d v=5.199

Базовые URL

• Боевой: https://api.vk.ru
• URL метода: https://api.vk.ru/method/<имя-API-метода>

Авторизация

Тип: Bearer-токен

Ключ доступа передаётся в каждом запросе в заголовке Authorization: Bearer <КЛЮЧ_ДОСТУПА>. Тип ключа указан у каждого метода: ключ пользователя, ключ сообщества или сервисный ключ приложения.

Ответ:

curl 'https://api.vk.ru/method/users.get' \
  -H 'Authorization: Bearer <КЛЮЧ_ДОСТУПА>' \
  -F 'user_ids=743784474' \
  -F 'fields=bdate' \
  -F 'v=5.131'

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

POST /method/users.get — Информация о пользователях

Ключи: пользователя, сообщества, сервисный.

Параметр	Где	Тип	Обяз.	Описание
v	body	string	да	Версия API
user_ids	body	array	нет	ID или короткие имена пользователей, до 1000; по умолчанию — текущий
fields	body	array	нет	Доп. поля: screen_name, sex, bdate, city, photo_100, online, last_seen и др.
name_case	body	string	нет	Падеж имени: nom (по умолчанию), gen, dat, acc, ins, abl

POST /method/utils.resolveScreenName — Тип и ID объекта по короткому имени

Ключи: пользователя, сообщества, сервисный.

Параметр	Где	Тип	Обяз.	Описание
v	body	string	да	Версия API
screen_name	body	string	да	Короткое имя пользователя, сообщества или приложения

POST /method/groups.getById — Информация о сообществах

Ключи: пользователя, сообщества, сервисный.

Параметр	Где	Тип	Обяз.	Описание
v	body	string	да	Версия API
group_ids	body	array	нет	ID или короткие имена сообществ
group_id	body	string	нет	ID или короткое имя одного сообщества
fields	body	array	нет	Доп. поля сообщества

Нюансы

• HTTP-методы GET и POST равнозначны; только HTTPS.
• Обязательный во всех запросах параметр v — версия API. В документации указана актуальная версия 5.131, а официальная JSON-схема методов VK описывает версию 5.199.
• Тело POST — application/x-www-form-urlencoded или multipart/form-data (для файлов и данных больше 2 КБ); application/json не поддерживается.
• Имя метода чувствительно к регистру.
• Общие параметры для всех методов: lang (ru, uk, be, en, es, fi, de, it) и test_mode=1.
• ID сообщества в owner_id передаётся со знаком минус.
• Кроме ограничений частоты есть закрытые количественные лимиты на однотипные методы: при превышении метод может стать временно недоступен или потребовать капчу.

Другие сценарии

• Бот сообщества: принимать сообщения через Long Poll
• Кнопки в боте сообщества
• Опубликовать пост с картинкой в сообществе
• Выгрузить участников сообщества

---

Если этого недостаточно — официальная документация: https://dev.vk.com/ru/api/api-requests Вся интеграция одним документом: https://mcp-everything.ru/integrations/vk-api.md