Developers » API methods » Friends »
Returns a list of friends matching the search criteria.
This method can be called with a user token. Access rights required: friends.
user_idUser ID.
positive number, current user id is used by default, required parameter
qSearch query string (e.g., Vasya Babich).
fieldsProfile fields to return. Sample values: nickname, screen_name, sex, bdate, city, country, timezone, photo_50, photo_100, photo_200_orig, has_mobile, contacts, education, online, relation, last_seen, status, can_write_private_message, can_see_all_posts, can_post, universities, domain.
list of comma-separated words
name_caseCase for declension of user name and surname:
  • nom Ś nominative (by default);
  • gen Ś genitive;
  • dat Ś dative;
  • acc Ś accusative;
  • ins Ś instrumental;
  • abl Ś prepositional.
string, default Nom
offsetOffset needed to return a specific subset of friends.
positive number
countNumber of friends to return.
positive number, default 20, maximum value 1000
Returns the total results number in count field and an array of objects describing users in items field.
Global errors can occur while running. See their descriptions on this page.