Telegram Bulk eKYCPro Avatar (Age and Gender) API: Profile Analysis & Demographics

Check the avatar information of the Telegram accounts for the input global phone numbers, including whether the account is active, profile picture URL, gender, age, hair color, and skin color.

上传检测文件示例：

curl --location 'https://api.ekycpro.com/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="tg_avatar"'

查询任务状态示例：

curl --location 'https://api.ekycpro.com/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

上传检测文件成功响应：

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

处理中状态响应：

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

任务完成响应（包含结果下载 URL）：

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

上传文件请求地址

POST https://api.ekycpro.com/v1/tasks

上传文件请求参数

参数	说明
file	file, 上传文件，每行一个手机号（E.164 格式）
task_type	string, 任务类型，设置为 “tg_avatar”

查询任务状态请求地址

POST https://api.ekycpro.com/v1/gettasks

查询任务状态请求参数

参数	说明
task_id	string, 创建任务返回的 Task ID

结果字段

字段	说明	示例
Number	Phone number in E.164 format	+41798284651
telegram	Whether number has active Telegram account	yes, no
avatar	URL of Telegram profile picture	https://example.com/avatar.jpg
age	Estimated age range based on profile picture	25
gender	Gender detected from profile picture	male, female
category	Type classification of profile picture	individual portrait, pet avatar, object, etc.
hair_color	Hair color detected from profile picture	black, brown, blonde, etc.
skin_color	Skin color detected from profile picture	white, black, etc.

响应字段

Field	Description
created_at	Timestamp when task was created
updated_at	Timestamp of last task status update
task_id	Unique task identifier
user_id	ID of user
status	Task status: pending: Queued and waiting processing: Currently processing exported: Results available for download
total	Total phone numbers processed
success	Numbers successfully identified
failure	Numbers that failed processing
result_url	(Optional) Download URL for results when status is exported

状态码

状态码	说明
200	charge, 请求成功，任务已创建或状态已获取
400	free, 请求参数或文件格式错误
500	free, 服务器内部错误，请稍后重试