Telegram 活跃度检测 · 批量

API 契约

两个调用就跑完一个任务

提交拿任务号，之后按任务号查询。任务成功时，查询响应里会带上结果文件的下载链接——没有第三个接口。

curl -X POST "https://tgvalidator.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_active_batch \
  -F file=@numbers.txt

curl "https://tgvalidator.com/api/v1/bulk-tasks/123" -H "X-API-Key: sk_your_api_key"

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 123,
    "product": "tg_active_batch",
    "status": "success",
    "total": 2000,
    "success_cnt": 2000,
    "charged_amount_micros": 8000000,
    "result_url": "https://…/result.zip"
  }
}

结果字段

结果文件里有哪些列

下载的是一个 zip：除这张完整结果表外，还会把已注册与未注册的号码分成两份名单。

执行方式

一个批量任务是怎么跑完的

批量不是把实时检测放大 —— 它是一次提交、后台执行、稍后取件。整个过程你不需要守着页面，任务状态和结果都留在后台。

1. 上传号码文件一行一个号码的 .txt 或 .csv。文件流式提交，服务器不落盘保存。
2. 预检并预扣先校验格式与国家一致性，通过后按有效行数预扣余额；预检不过不扣一分钱。
3. 后台执行任务在后台跑，你可以关掉页面。失败会立即反馈并全额退款。
4. 下载结果文件完成后在批量检测页下载。只按实际返回结果的号码计费，差额自动退回。

适用场景

什么时候该用这一款

• 活号与沉默号分层
• 重激活名单排序
• 投放预算分配
• 名单质量评估

Telegram 活跃度检测（批量）在注册状态之外，额外返回用户 ID、用户名、最近在线时间、活跃天数与会员标记。已注册不等于还在用——这款产品用于把长期不在线的号码从名单里分出来。

能力边界

这款产品不做什么

• 不做身份认证。结果只说明这个号码在平台上的公开状态，不能用来确认号码归属人。
• 不返回聊天记录、会话内容或任何私密账号内容。
• 提交任务时选定号码所属的国家/地区。名单应基本属于这一个国家——同拨号区的邻国号不算跨国，确属其它国家的号码超过 10% 会在扣费之前被拒绝。
• 结果反映任务执行那一刻的状态。需要最新状态就重新跑一次，我方不会自动刷新历史结果。
• 下载链接有时效。任务完成后请尽快下载，过期后可再次查询任务重新获取链接。

产品常见问题

关于活跃度检测

如何选择

实时检测还是批量检测

实时检测 · 查看价格

相关产品

其他批量产品