vk_groups_search
Search VK communities by keyword and optional filters like type, location, and market. Retrieve matching groups, pages, or events for audience targeting.
Instructions
Returns a list of communities matching the search criteria. VK API method: groups.search. Tool name: vk_groups_search. Section: groups. Access level: read.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query string. | |
| type | No | Community type. Possible values: 'group, page, event.' | |
| country_id | No | Country ID. | |
| city_id | No | City ID. If this parameter is transmitted, country_id is ignored. | |
| future | No | '1' - to return only upcoming events. Works with the 'type' = 'event' only. | |
| market | No | '1' - to return communities with enabled market only. | |
| sort | No | Sort order. Possible values: *'0' - default sorting (similar the full version of the site),, *'1' - by growth speed,, *'2'- by the "day attendance/members number" ratio,, *'3' - by the "Likes number/members number" ratio,, *'4' - by the "comments number/members number" ratio,, *'5' - by the "boards entries number/members number" ratio. | |
| offset | No | Offset needed to return a specific subset of results. | |
| count | No | Number of communities to return. "Note that you can not receive more than first thousand of results, regardless of 'count' and 'offset' values." |