Search communities
vk_groups_searchRead-onlyIdempotent
Search for communities by keyword. Filter results by type, country, city, or sort order to find groups, pages, or events.
Instructions
Find communities by keyword, optionally narrowed by type, country, city or sort order. Returns matches with a total count.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query | |
| sort | No | Sort order: 0 — default, 1 — by speed, 6 — by likes | |
| type | No | Community type: group, page or event | |
| count | No | Number of results (max 1000) | |
| fields | No | Additional community fields to return | |
| future | No | Filter future events: 1 — only future events | |
| offset | No | Offset for pagination | |
| city_id | No | City ID to filter by | |
| country_id | No | Country ID to filter by |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Total number of matches on VK, which is usually larger than the returned page | |
| items | Yes | Matching communities | |
| pagination | No | Where this page sits in the whole result. Call the tool again with offset set to next_offset to continue; when next_offset is null there is nothing left to fetch. |