Reference
Search public groups
Search public Telegram groups by keyword from an account. Follow the operation for hits.
View MarkdownThis page is generated from the source code on every release.
Search public Telegram groups by keyword from an account. Follow the operation for hits.
Overview
| Name | Value |
|---|---|
| Code | groups.search |
| Scope needed | discovery.write |
| Risk | Write |
| May need confirmation | No |
| Runs as | Queues work for a node |
Needs Idempotency-Key |
No |
| Member roles allowed | owner, manager |
| In the app | Discover → Search groups |
Input fields
| Field | Type | Required | Description |
|---|---|---|---|
accountId |
uuid |
Yes | |
query |
text |
Yes |
Example request
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.search \
-H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"accountId":"00000000-0000-0000-0000-000000000000","query":"…"}'Output fields (data)
| Field | Type | Required |
|---|---|---|
ok |
true |
Yes |
searchId |
text |
Yes |
Example answer
{
"data": {
"ok": true,
"searchId": "00000000-0000-4000-8000-000000000000"
}
}Using it over MCP
Tool groups_search is listed on the profiles: Discover (prospecting). On other profiles, find it with tools_search and run it with tools_run.