Telegram 用户名画像检测 API

task_type=tg_username_profile

输入与数量限制

Telegram 用户名. 上传文本文件，每行一个值。只处理你有权检测的标识符。

最低上传数量：500。最高上传数量：10,000,000。最低计费数量：0。最低上传数量与最低计费数量不同；较小的有效上传仍可能按最低计费数量收费。0 表示没有计费下限。完全失败或未处理的任务不会凭空按最低数量计费。提交前请查看账户当前价格。

创建任务

curl --request POST 'https://api.numberchecker.ai/v1/tasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'file=@input.txt' \
  --form 'task_type=tg_username_profile'

轮询与下载

保存返回的 task_id。轮询至 status=exported 后下载 result_url。pending 和 processing 表示尚未完成，failed 表示失败。创建请求超时后不要自动重交，原请求可能已成功创建任务。

curl --request POST 'https://api.numberchecker.ai/v1/gettasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'task_id=YOUR_TASK_ID'

CSV 字段

username,activated,avatar_url,uid,lastseen,activedays,member,category,gender,hair_color,skin_color,age

保留列顺序和大小写。空值或无法确定的结果不等于明确的否定结果。

画像提取需要公开头像。没有公开头像的账户在注册检测后停止，后续活跃度和画像字段可能为空。头像推测的属性属于估计，并非经过核实的个人事实。这是 Profile，不同于 Activity；原 Full 产品已经停用。不要自动替换任务类型。

认证与错误处理

通过 X-API-Key 请求头传递服务端密钥。400：输入无效；401：密钥无效；402：余额不足；404：任务不存在；413：文件过大。状态查询可采用有上限的退避重试，并保留原任务 ID。

当前价格

契约核验日期：2026-10-30。数量限制可能变化，请在提交前查看控制台。