如何查询号码是否注册了 Telegram（检测 API）

发布于 2026年8月23日

Telegram 拥有超过十亿用户，在许多地区和社区里它是主要的消息渠道——这也让「这个联系人用 Telegram 吗？」成为一个值得在搭建触达、客服或验证流程之前先回答的问题。Telegram 号码检测只需一次 API 调用就能给出答案。

本指南介绍如何查询某个号码（或用户名）是否注册了 Telegram，以及如何获取已注册账户的公开简介与头像。

第一步 —— 获取 API Key

注册，打开控制台，复制一个有效 API Key。账户赠送免费点数，可用于测试。

第二步 —— 校验是否注册

check-exists 接口接收 peer 参数，它可以是国际格式的手机号（纯数字），也可以是 Telegram 用户名：

curl "https://api.opendata-api.com/api/project/telegram/check-exists?key=你的API_KEY&peer=15551234567"

能直接传用户名这一点特别实用——当你只有对方的 Telegram 用户名而没有手机号时也能查询。

对于已注册的 peer，校验结果会返回一个标识符（userHash），供资料查询接口使用。

第三步 —— 获取简介与头像

把校验得到的 userHash 传入资料接口：

# 简介 /「关于」文本
curl "https://api.opendata-api.com/api/project/telegram/get-about?key=你的API_KEY&userHash=USER_HASH"

# 头像
curl "https://api.opendata-api.com/api/project/telegram/get-picture?key=你的API_KEY&userHash=USER_HASH"

把成本低廉的存在性校验与资料查询分开，意味着你只为「确实存在」的 peer 支付补全成本。

应用场景

  • 渠道路由 —— 只对确认在用 Telegram 的联系人走 Telegram 发送。
  • 社群与线索研究 —— 为 Telegram 用户名补全简介与头像数据。
  • 验证流程 —— 确认用户拥有一个可触达的 Telegram 账户。
  • 名单清洗 —— 从 Telegram 专项活动中剔除未注册联系人。

最佳实践

  • 号码与用户名都支持 —— 当你只有用户名时，不必强求手机号。
  • 先校验再补全 —— 对未通过校验的 peer，跳过简介/头像查询。
  • 缓存 userHash，避免重复查询额外消耗点数。
  • 遵守平台规则与隐私法规 —— 只处理你有正当依据使用的联系人。

立即体验

在 Telegram 号码校验页面在线测试，或阅读 check-exists 接口文档。需要超出免费点数时查看定价。