✈️

Telegram 号码校验与资料查询 APIs

按手机号、用户名或用户 ID 查询 Telegram 用户的公开资料。

两步流程:先调用「存在性检测」获取 userHash,再将其传给「About / 头像」接口。

RESTful JSON API,适用于线索校验、CRM 数据增强与客户情报。

打开交互式演示

概览

💡

基础 URL https://api.opendata-api.com

每次调用都需要 API Key。在下方粘贴一次,之后每个请求都会自动附带。

GET /api/project/telegram/check-exists

检测 Telegram 账号是否存在

说明

解析 peer 并返回它是否注册在 Telegram 上——最便宜的查询,适合在 About/头像查询前预校验号码或用户名。当 exists=true 时,响应还会包含 Telegram 数字用户 ID、用户名(若有)、显示昵称,以及一个 userHash,需将其传给 About/头像接口以授权更重的查询。peer 支持完整国际号码、用户名或数字用户 ID。

ParameterInValue
peer* path
curl -X GET 'https://api.opendata-api.com/api/project/telegram/check-exists?key=<API_KEY>&peer=<peer>'
GET /api/project/telegram/get-about

获取 About / 简介

说明

获取 Telegram 用户的公开 About(简介)文本,以及数字用户 ID 与用户名。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。简介未设置或被隐私隐藏时返回空。

ParameterInValue
userHash* query
curl -X GET 'https://api.opendata-api.com/api/project/telegram/get-about?key=<API_KEY>&userHash=<userHash>'
GET /api/project/telegram/get-picture

获取头像(资料照片)

说明

获取 Telegram 用户的头像(资料照片),以 base64 编码返回(Telegram 头像无公开 URL)。两步流程:先调用「检测 Telegram 账号是否存在」获取目标 peer 的 userHash,再将其传到此处。无有效(或已过期/未知)userHash 的调用会被拒绝。peer 由 userHash 在服务端解析,不接受号码参数。未设置头像或因隐私隐藏时 pictureSet=false。

ParameterInValue
userHash* query
curl -X GET 'https://api.opendata-api.com/api/project/telegram/get-picture?key=<API_KEY>&userHash=<userHash>'