users.search
Возвращает список пользователей в соответствии с заданным критерием поиска.
Этот метод можно вызвать с ключом доступа пользователя.
Параметры
string
Строка поискового запроса. Например, Вася Бабич
.
string
Сортировка результатов. Возможные значения:
- •
1
— по дате регистрации, - •
0
— по популярности.
string
Смещение относительно первого найденного пользователя для выборки определенного подмножества.
string
Количество возвращаемых пользователей.
Обратите внимание, даже при использовании параметра
offset
для получения информации доступны только первые 1000 результатов.
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
.
string
Идентификатор города.
string
string
Идентификатор страны.
string
string
Название города строкой.
string
Идентификатор страны, в которой пользователи закончили ВУЗ.
string
Идентификатор ВУЗа.
string
Год окончания ВУЗа.
string
Идентификатор факультета.
string
Идентификатор кафедры.
string
Пол. Возможные значения:
- •
1
— женщина, - •
2
— мужчина, - •
0
— любой (по умолчанию).
string
Семейное положение. Возможные значения:
- •
1
— не женат (не замужем), - •
2
— встречается, - •
3
— помолвлен(-а), - •
4
— женат (замужем), - •
5
— всё сложно, - •
6
— в активном поиске, - •
7
— влюблен(-а), - •
8
— в гражданском браке.
string
Возраст, от.
string
Возраст, до.
string
День рождения.
string
Месяц рождения.
string
Год рождения.
string
Учитывать ли статус «онлайн». Возможные значения:
- •
1
— искать только пользователей онлайн, - •
0
— искать по всем пользователям.
string
Учитывать ли наличие фото. Возможные значения:
- •
1
— искать только пользователей с фотографией, - •
0
— искать по всем пользователям.
string
Идентификатор страны, в которой пользователи закончили школу.
string
Идентификатор города, в котором пользователи закончили школу.
string
Буква класса.
string
Идентификатор школы, которую закончили пользователи.
string
Год окончания школы.
string
Религиозные взгляды.
string
Название компании, в которой работают пользователи.
string
Название должности.
string
Идентификатор группы, среди пользователей которой необходимо проводить поиск.
string
Разделы среди которых нужно осуществить поиск, перечисленные через запятую. Возможные значения:
- •
friends
— искать среди друзей, - •
subscriptions
— искать среди друзей и подписок пользователя.
Результат
После успешного выполнения возвращает объект, содержащий число результатов в поле count
и массив объектов, описывающих пользователей в поле items
.
Коды ошибок
В ходе выполнения могут произойти общие ошибки.