vk_users_search
Search VK users by name, location, age, education, and other filters to find matching profiles.
Instructions
Returns a list of users matching the search criteria. VK API method: users.search. Tool name: vk_users_search. Section: users. Access level: read.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query string (e.g., 'Vasya Babich'). | |
| sort | No | Sort order: '1' - by date registered, '0' - by rating | |
| offset | No | Offset needed to return a specific subset of users. | |
| count | No | Number of users to return. | |
| fields | No | Profile fields to return. Sample values: 'nickname', 'screen_name', 'sex', 'bdate' (birthdate), 'city', 'country', 'timezone', 'photo', 'photo_medium', 'photo_big', 'has_mobile', 'rate', 'contacts', 'education', 'online', | |
| city | No | City ID. | |
| city_id | No | City ID. Use parameter city instead | |
| country | No | Country ID. | |
| country_id | No | Country ID. Use parameter country instead | |
| hometown | No | City name in a string. | |
| university_country | No | ID of the country where the user graduated. | |
| university | No | ID of the institution of higher education. | |
| university_year | No | Year of graduation from an institution of higher education. | |
| university_faculty | No | Faculty ID. | |
| university_chair | No | Chair ID. | |
| sex | No | '1' - female, '2' - male, '0' - any (default) | |
| status | No | Relationship status: '0' - Not specified, '1' - Not married, '2' - In a relationship, '3' - Engaged, '4' - Married, '5' - It's complicated, '6' - Actively searching, '7' - In love, '8' - In a civil union | |
| age_from | No | Minimum age. | |
| age_to | No | Maximum age. | |
| birth_day | No | Day of birth. | |
| birth_month | No | Month of birth. | |
| birth_year | No | Year of birth. | |
| online | No | '1' - online only, '0' - all users | |
| has_photo | No | '1' - with photo only, '0' - all users | |
| school_country | No | ID of the country where users finished school. | |
| school_city | No | ID of the city where users finished school. | |
| school_class | No | ||
| school | No | ID of the school. | |
| school_year | No | School graduation year. | |
| religion | No | Users' religious affiliation. | |
| company | No | Name of the company where users work. | |
| position | No | Job position. | |
| group_id | No | ID of a community to search in communities. | |
| from_list | No | ||
| screen_ref | No | ||
| from_group_id | No |