按手机号、用户名或用户 ID 查询 Telegram 用户的公开资料。
两步流程:先调用「存在性检测」获取 userHash,再将其传给「About / 头像」接口。
RESTful JSON API,适用于线索校验、CRM 数据增强与客户情报。
基础 URL https://api.opendata-api.com
每次调用都需要 API Key。在下方粘贴一次,之后每个请求都会自动附带。
/api/project/telegram/check-exists 检测 Telegram 账号是否存在
解析 peer 并返回它是否注册在 Telegram 上——最便宜的查询,适合在 About/头像查询前预校验号码或用户名。当 exists=true 时,响应还会包含 Telegram 数字用户 ID、用户名(若有)、显示昵称,以及一个 userHash,需将其传给 About/头像接口以授权更重的查询。peer 支持完整国际号码、用户名或数字用户 ID。
| Parameter | In | Value |
|---|---|---|
peer* | path |
/api/project/telegram/get-about 获取 About / 简介
获取 Telegram 用户的公开 About(简介)文本,以及数字用户 ID 与用户名。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。简介未设置或被隐私隐藏时返回空。
| Parameter | In | Value |
|---|---|---|
userHash* | query |
/api/project/telegram/get-picture 获取头像(资料照片)
获取 Telegram 用户的头像(资料照片),以 base64 编码返回(Telegram 头像无公开 URL)。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。peer 由 userHash 在服务端解析,不接受号码参数。未设置头像或因隐私隐藏时 pictureSet=false。
| Parameter | In | Value |
|---|---|---|
userHash* | query |