API 权限开放中 · 150 USDT 开通

Telegram 发言查询与群关系 API 文档

将酷酷助手里的发言关联能力封装为标准 API：用户画像、发言记录、共同群组、用户名历史、文本搜索等能力，一页查看所有调用方式。

查看全部 API150 USDT 开通权限
curl example
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/messages?page=1&pageSize=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
19+
接口能力
覆盖用户、群组、发言、历史记录
150U
权限开通
一次开通 API Key 使用权限
Bearer
鉴权方式
标准 Authorization 请求头
JSON
返回格式
统一 JSON 响应，方便接入系统
01

风控画像

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

02

群关系分析

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

03

发言追踪

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

04

用户名溯源

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

05

自动化审核

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

06

数据看板

通过标准 HTTP API 快速接入你的机器人、后台系统、风控工具或数据看板。

Authentication

统一 Bearer Token 鉴权

开通后会发放专属 API Key。所有接口在请求头中携带 Authorization 即可调用。

GET https://ttapi.tgovo.com/api/v1/users/{id}/stats
Authorization: Bearer YOUR_API_KEY
Accept: application/json
API Catalog

全部接口调用方式

以下接口按酷酷助手发言关联模块当前能力整理。实际计费以开通后返回为准。

Base URL：https://ttapi.tgovo.com
01GETFREE

用户基础统计

查询用户基础画像、首次/最近活跃、发言概览。

/api/v1/users/{id}/stats_min
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/stats_min" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
02GETFREE

用户群组数量

统计用户所在群组数量，可只统计有发言群组。

/api/v1/users/{id}/groups_count
  • • id: Telegram 用户 ID
  • • onlyMsg=true: 只看有发言群组
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/groups_count?onlyMsg=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
03GETFREE

用户消息数量

查询用户公开发言数量。

/api/v1/users/{id}/messages_count
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/messages_count" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
04GET0.01

群基础信息

查询群组基础资料。

/api/v1/groups/{id}
  • • id: Telegram 群 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/groups/-1001234567890" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
05GET0.1

文本搜索

按关键词搜索公开消息。

/api/v1/text/search
  • • input: 搜索文本
  • • page: 页码
  • • pageSize: 每页数量
curl -X GET "https://ttapi.tgovo.com/api/v1/text/search?input=hello&page=1&pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
06GET0.1/成功

ID 查用户信息

批量根据 ID 查询用户信息。

/api/v1/users/basic_info_by_id
  • • id: 一个或多个用户 ID，可重复传参
curl -X GET "https://ttapi.tgovo.com/api/v1/users/basic_info_by_id?id=123456789&id=987654321" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
07GET0.1/成功

解析用户名

将 @username 解析为用户 ID。

/api/v1/users/resolve_username
  • • name: 一个或多个 username，可重复传参
curl -X GET "https://ttapi.tgovo.com/api/v1/users/resolve_username?name=telegram&name=durov" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
08GET0.1

用户名使用记录

查询某个用户名的历史使用记录。

/api/v1/users/username_usage
  • • username: 不带 @ 的用户名
curl -X GET "https://ttapi.tgovo.com/api/v1/users/username_usage?username=telegram" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
09GET0.5

多用户共同群组

查询多个用户之间的共同群组。

/api/v1/groups/common_groups
  • • id: 多个用户 ID，可重复传参
curl -X GET "https://ttapi.tgovo.com/api/v1/groups/common_groups?id=123456789&id=987654321" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
10GET1

用户完整统计

完整用户画像、角色、活跃时间、群组统计。

/api/v1/users/{id}/stats
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/stats" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
11GET1/成功

用户贴纸包

查询用户相关贴纸包信息。

/api/v1/users/{id}/stickers
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/stickers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
12GET3

姓名历史

查询用户姓名变更历史。

/api/v1/users/{id}/names
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/names" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
13GET3

用户名历史

查询用户 username 变更历史。

/api/v1/users/{id}/usernames
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/usernames" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
14GET5

共同群组统计

查询指定用户与其他用户/群组的共同群组统计。

/api/v1/users/{id}/common_groups_stat
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/common_groups_stat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
15GET5/超过5条

礼物关系

查询 Telegram 礼物关联数据。

/api/v1/users/{id}/gifts_relation
  • • id: Telegram 用户 ID
  • • page: 页码
  • • pageSize: 每页数量
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/gifts_relation?page=1&pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
16GET5

用户所有群组

查询用户公开关联群组列表。

/api/v1/users/{id}/groups
  • • id: Telegram 用户 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
17GET10/超过100条

用户消息列表

查询用户公开发言记录，支持分页。

/api/v1/users/{id}/messages
  • • id: Telegram 用户 ID
  • • page: 页码
  • • pageSize: 每页数量
curl -X GET "https://ttapi.tgovo.com/api/v1/users/123456789/messages?page=1&pageSize=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
18GET15

群成员列表

查询指定群组成员列表。

/api/v1/groups/{id}/members
  • • id: Telegram 群 ID
curl -X GET "https://ttapi.tgovo.com/api/v1/groups/-1001234567890/members" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
19GET文档未标

姓名使用记录

按姓名关键词查询使用记录。

/api/v1/users/name_usage
  • • name: 姓名关键词
  • • page: 页码
  • • pageSize: 每页数量
curl -X GET "https://ttapi.tgovo.com/api/v1/users/name_usage?name=Tom&page=1&pageSize=20" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Pricing
150 USDT

开通 API 权限，发放专属 Key，可接入你的机器人、后台或业务系统。

如何开通 API 权限？

  1. 1. 联系客服确认使用场景与调用额度。
  2. 2. 支付 150 USDT 开通 API 权限。
  3. 3. 获取专属 API Key，并按本文档直接调用。
Telegram 联系开通