← Назад к API

Пользователи

Методы для получения информации о пользователях, поиска и работы с профилями

GET users.get

Получение информации о пользователях по их ID.

Параметры:

user_ids — ID пользователей через запятую (по умолчанию текущий пользователь)

fields — Дополнительные поля (см. ниже)

offset — Смещение для выборки

count — Количество пользователей (макс. 100)

Доступные поля (fields):

verified, sex, has_photo, photo_50, photo_100, photo_200, photo_max, photo_max_orig, status, screen_name, friend_status, last_seen, music, movies, tv, books, city, interests, quotes, games, email, telegram, about, rating, counters, correct_counters, guid, background, reg_date, is_dead, nickname, blacklisted_by_me, blacklisted, custom_fields, bdate

Пример:

GET /method/users.get.json?user_ids=1,2&fields=photo_100,city,status

Ответ:

[{
  "id": 1,
  "first_name": "Иван",
  "last_name": "Петров",
  "is_closed": false,
  "can_access_closed": true,
  "photo_100": "https://...",
  "city": "Москва",
  "status": "В сети",
  "online": 1
}]

GET users.search

Поиск пользователей по различным параметрам.

Параметры:

q * — Поисковый запрос

fields — Дополнительные поля

offset — Смещение (по умолчанию 0)

count — Количество результатов (макс. 100)

city — Город

hometown — Родной город

sex — Пол (0-любой, 1-жен., 2-муж., 3-не указ.)

status — Семейное положение

online — true - только онлайн

sort — Сортировка (0-по ID, 1-по ID desc, 4-по рейтингу)

interests — Интересы

fav_music — Любимая музыка

Пример:

GET /method/users.search.json?q=Иван&city=Москва&count=20

Ответ:

{
  "count": 150,
  "items": [{ /* массив пользователей */ }]
}

GET users.getFollowers

Получение списка подписчиков пользователя.

Параметры:

user_id * — ID пользователя

fields — Дополнительные поля

offset — Смещение (по умолчанию 0)

count — Количество подписчиков (макс. 100)

Пример:

GET /method/users.getFollowers.json?user_id=123&count=20

Ответ:

{
  "count": 50,
  "items": [1, 2, 3] // массив ID подписчиков
}

POST users.report

Подача жалобы на пользователя.

Параметры:

user_id * — ID пользователя

type — Тип жалобы (по умолчанию "spam")

comment — Комментарий к жалобе

Пример:

POST /method/users.report.json?user_id=123&type=spam&comment=Спам в сообщениях

Ответ:

1 // Успешно

📋 Описание дополнительных полей

counters — Счетчики (друзья, фото, видео, аудио, заметки)

friend_status — Статус дружбы (0-не друг, 1-заявка отправлена, 2-входящая заявка, 3-друзья)

last_seen — Время последнего посещения и платформа

bdate — Дата рождения (зависит от настроек приватности)

rating — Рейтинг пользователя