CheckNumber.AI· 4 min read
Telegram 号码检测器 — 通过平台或 API 批量验证账户 | CheckNumber.AI
通过 API 或 CSV 批量验证 Telegram 注册状态的分步指南与代码示例。约 $2.50/万次检测。
检测全球手机号是否已注册 Telegram。
Telegram 已是全球主流即时通讯平台之一；企业需要在营销、合规与数据校验场景中验证号码是否开通 Telegram。
为什么要做 Telegram 注册检测？
- 营销名单：筛出可通过 Telegram 触达的联系人
- 数据校验：确认客户号码真实开通 Telegram
- 合规与质量：保证 B2B/B2C 数据库准确
- 线索打分：优先跟进活跃使用 Telegram 的线索
Telegram 批量号码检测 API
官方文档：Telegram Bulk CheckNumber API.
CheckNumber 以 批量任务 方式验证：上传 .txt / .csv（每行一个 E.164 号码）→ 轮询任务状态 → 下载结果文件。所有请求使用 X-API-Key 请求头。
提交任务
POST https://api.checknumber.ai/v1/tasks
| 参数 | 说明 |
|---|---|
file | 每行一个号码，E.164 |
task_type | tg — Telegram 注册检测 |
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="tg"'
查询任务状态
POST https://api.checknumber.ai/v1/gettasks
| 参数 | 说明 |
|---|---|
task_id | 创建任务时返回 |
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
当 status 为 exported 时，通过 result_url 下载结果。
结果字段
| 字段 | 说明 | 示例 |
|---|---|---|
Number | E.164 号码 | +41798284651 |
telegram | 是否注册 Telegram | yes, no |
任务载荷字段
| 字段 | 说明 |
|---|---|
created_at | 创建时间 |
updated_at | 最近状态更新时间 |
task_id | 任务 ID |
status | pending、processing 或 exported |
total | 文件内号码总数 |
success | 已完成行数 |
failure | 失败行数 |
result_url | exported 时的下载链接 |
HTTP 状态码
| 状态 | 计费 | 含义 |
|---|---|---|
200 | 计费 | 任务创建或返回状态 |
400 | 不计费 | 参数或文件无效 |
500 | 不计费 | 服务端错误，请稍后重试 |
集成清单
FAQ
问：验证 100 万条 Telegram 号码大约要多久？
答：处理速度因平台速率限制而异，具体时间取决于服务器负载。
问：会向号码发送消息吗？
答：不会。仅查询注册状态，不发送任何消息或通知。
问：能否在一个任务里同时测 Telegram 与其它平台？
答：不能。每个任务对应单一 task_type（Telegram 为 tg）。多平台请分别提交批量任务并可并行处理。
问：任务中途余额不足会怎样？
答：任务会按已有额度继续处理已排队数据；已处理行计费，其余可能标记失败。