Данный сайт является КЛОНОМ оффициальной документации dev.vk.com
Настоятельно рекомендуется воздержаться от ввода личной информации.
Сайт создан на случай падения оффициальной документации.

Дата создания: 13.11.2022
users

users.search

Возвращает список пользователей в соответствии с заданным критерием поиска.

Этот метод можно вызвать с ключом доступа пользователя.

Параметры

q

string

Строка поискового запроса. Например, Вася Бабич.

sort

string

Сортировка результатов. Возможные значения:

  • 1 — по дате регистрации,
  • 0 — по популярности.
offset

string

Смещение относительно первого найденного пользователя для выборки определенного подмножества.

count

string

Количество возвращаемых пользователей.

Обратите внимание, даже при использовании параметра offset для получения информации доступны только первые 1000 результатов.

fields

string

Список дополнительных полей профилей, которые необходимо вернуть. См. подробное описание. Доступные значения:

  • about,
  • activities,
  • bdate,
  • blacklisted,
  • blacklisted_by_me
  • books,
  • can_post,
  • can_see_all_posts,
  • can_see_audio,
  • can_send_friend_request,
  • can_write_private_message,
  • career,
  • city,
  • common_count,
  • connections,
  • contacts,
  • country,
  • crop_photo,
  • domain,
  • education,
  • exports,
  • followers_count,
  • friend_status,
  • games,
  • has_mobile,
  • has_photo,
  • home_town,
  • interests,
  • is_favorite,
  • is_friend,
  • is_hidden_from_feed,
  • last_seen,
  • lists,
  • maiden_name,
  • military,
  • movies,
  • music,
  • nickname,
  • occupation,
  • online,
  • personal,
  • photo_100,
  • photo_200,
  • photo_200_orig,
  • photo_400_orig,
  • photo_50,
  • photo_id,
  • photo_max,
  • photo_max_orig,
  • quotes,
  • relation,
  • relatives,
  • schools,
  • screen_name,
  • sex,
  • site,
  • status,
  • timezone,
  • tv,
  • universities,
  • verified,
  • wall_comments.
city

string

Идентификатор города.

city_id

string

country

string

Идентификатор страны.

country_id

string

hometown

string

Название города строкой.

university_country

string

Идентификатор страны, в которой пользователи закончили ВУЗ.

university

string

Идентификатор ВУЗа.

university_year

string

Год окончания ВУЗа.

university_faculty

string

Идентификатор факультета.

university_chair

string

Идентификатор кафедры.

sex

string

Пол. Возможные значения:

  • 1 — женщина,
  • 2 — мужчина,
  • 0 — любой (по умолчанию).
status

string

Семейное положение. Возможные значения:

  • 1 — не женат (не замужем),
  • 2 — встречается,
  • 3 — помолвлен(-а),
  • 4 — женат (замужем),
  • 5 — всё сложно,
  • 6 — в активном поиске,
  • 7 — влюблен(-а),
  • 8 — в гражданском браке.
age_from

string

Возраст, от.

age_to

string

Возраст, до.

birth_day

string

День рождения.

birth_month

string

Месяц рождения.

birth_year

string

Год рождения.

online

string

Учитывать ли статус «онлайн». Возможные значения:

  • 1 — искать только пользователей онлайн,
  • 0 — искать по всем пользователям.
has_photo

string

Учитывать ли наличие фото. Возможные значения:

  • 1 — искать только пользователей с фотографией,
  • 0 — искать по всем пользователям.
school_country

string

Идентификатор страны, в которой пользователи закончили школу.

school_city

string

Идентификатор города, в котором пользователи закончили школу.

school_class

string

Буква класса.

school

string

Идентификатор школы, которую закончили пользователи.

school_year

string

Год окончания школы.

religion

string

Религиозные взгляды.

company

string

Название компании, в которой работают пользователи.

position

string

Название должности.

group_id

string

Идентификатор группы, среди пользователей которой необходимо проводить поиск.

from_list

string

Разделы среди которых нужно осуществить поиск, перечисленные через запятую. Возможные значения:

  • friends — искать среди друзей,
  • subscriptions — искать среди друзей и подписок пользователя.

Результат

После успешного выполнения возвращает объект, содержащий число результатов в поле count и массив объектов, описывающих пользователей в поле items.

Коды ошибок

В ходе выполнения могут произойти общие ошибки.

Пример запроса

Ввести вручную
{
}