TTAPI API 文档
通过标准 REST API 接入 Telegram 公开数据查询能力。所有响应均为 JSON。
Base URL
https://ttapi.tgovo.comAuthentication
Bearer Token鉴权方式
API Key 开通费用为 150 USDT。请仅在服务端安全保存，不要提交到公开代码仓库。
Authorization: Bearer YOUR_API_KEY
Accept: application/json免费接口
以下 3 个基础统计接口无需支付，可直接在线查询或使用自己的 API Key 调用。
GET
获取用户基本统计
FREE/api/v1/users/{id}/stats_min免费查询用户基础画像、首次与最近活跃、消息和群组概览。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/stats_min" \
-H "Authorization: Bearer YOUR_API_KEY"GET
查询用户群组数量
FREE/api/v1/users/{id}/groups_count免费统计用户公开关联的群组数量。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/groups_count?onlyMsg=true" \
-H "Authorization: Bearer YOUR_API_KEY"GET
查询用户消息数量
FREE/api/v1/users/{id}/messages_count免费查询用户的公开消息数量。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/messages_count" \
-H "Authorization: Bearer YOUR_API_KEY"按次计费接口
按调用次数计费，价格以 TRX 标注；在线付款时按多源实时汇率折算 USDT。
GET
通过用户名查询用户基本信息
0.01 TRX / 次/api/v1/users/resolve_username将公开用户名解析为用户基础资料和 Telegram ID。
curl "https://ttapi.tgovo.com/api/v1/users/resolve_username?name=telegram" \
-H "Authorization: Bearer YOUR_API_KEY"GET
通过 ID 查询用户基本信息
0.01 TRX / 次/api/v1/users/basic_info_by_id通过一个或多个 Telegram ID 查询用户基础资料。
curl "https://ttapi.tgovo.com/api/v1/users/basic_info_by_id?id=123456789" \
-H "Authorization: Bearer YOUR_API_KEY"GET
获取用户消息记录
0.6 TRX / 次/api/v1/users/{id}/messages分页查询用户公开消息记录。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/messages?page=1&pageSize=10" \
-H "Authorization: Bearer YOUR_API_KEY"GET
获取用户群组列表
0.2 TRX / 次/api/v1/users/{id}/groups查询用户公开关联群组列表。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/groups" \
-H "Authorization: Bearer YOUR_API_KEY"GET
获取用户名称历史
0.1 TRX / 次/api/v1/users/{id}/names查询用户姓名变更历史。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/names" \
-H "Authorization: Bearer YOUR_API_KEY"GET
获取用户 @username 历史
0.1 TRX / 次/api/v1/users/{id}/usernames查询公开用户名变更历史。
curl "https://ttapi.tgovo.com/api/v1/users/123456789/usernames" \
-H "Authorization: Bearer YOUR_API_KEY"GET
搜索触发指定关键词的用户
0.04 TRX / 次/api/v1/text/search按关键词搜索公开消息及其发送用户。
curl "https://ttapi.tgovo.com/api/v1/text/search?input=hello&page=1&pageSize=20" \
-H "Authorization: Bearer YOUR_API_KEY"GET
采集群成员
1 TRX / 次/api/v1/groups/{id}/members采集指定公开群组的已知成员。
curl "https://ttapi.tgovo.com/api/v1/groups/-1001234567890/members" \
-H "Authorization: Bearer YOUR_API_KEY"GET
通过关键词采集群组
0.1 TRX / 次/api/v1/collect/groups根据公开用户名关键词整理相关群组。
curl "https://ttapi.tgovo.com/api/v1/collect/groups?keyword=telegram" \
-H "Authorization: Bearer YOUR_API_KEY"GET
通过关键词采集频道
0.1 TRX / 次/api/v1/collect/channels根据公开用户名关键词整理相关频道。
curl "https://ttapi.tgovo.com/api/v1/collect/channels?keyword=telegram" \
-H "Authorization: Bearer YOUR_API_KEY"GET
通过关键词采集机器人
0.1 TRX / 次/api/v1/collect/bots根据公开用户名关键词整理相关机器人。
curl "https://ttapi.tgovo.com/api/v1/collect/bots?keyword=telegram" \
-H "Authorization: Bearer YOUR_API_KEY"