---
title: "Tìm nhóm công khai"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.search
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Tìm nhóm công khai

Tìm nhóm Telegram công khai theo từ khoá từ một tài khoản. Theo dõi thao tác để nhận kết quả.

Tìm nhóm Telegram công khai theo từ khoá từ một tài khoản. Theo dõi thao tác để nhận kết quả.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.search` |
| Scope cần | `discovery.write` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
| Cần `Idempotency-Key` | Không |
| Vai trò thành viên được phép | `owner`, `manager` |
| Trong app | Tìm khách → Tìm nhóm |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `accountId` | `uuid` | Có |   |
| `query` | `chữ` | Có |   |

## Ví dụ gọi

```bash
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":"…"}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `searchId` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "searchId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Tool `groups_search` có tên sẵn trong profile: Tìm khách (`prospecting`). Ở profile khác, tìm bằng `tools_search` rồi chạy bằng `tools_run`.