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.

Ejemplo para subir el archivo de detección:

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

Ejemplo para consultar el estado de la tarea:

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

Respuesta cuando la carga del archivo fue exitosa:

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

Respuesta para el estado de procesamiento:

{
    "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
}

Respuesta cuando la tarea está completada (incluye la URL de descarga):

{
    "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..."
}

URL de solicitud para subir archivo

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

Parámetros de solicitud para subir archivo

Parámetro	Descripción
file	file, Sube un archivo; cada línea debe contener un número en formato E.164
task_type	string, Tipo de tarea, establecer en “tg_avatar”

URL de solicitud para consultar estado

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

Parámetros de solicitud para consultar estado

Parámetro	Descripción
task_id	string, ID de tarea devuelto al crear la tarea

Campos del resultado

Campo	Descripción	Ejemplo
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.

Formato de respuesta

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

Códigos de estado

Estado	Descripción
200	charge, Request successful, task created or status retrieved
400	free, Bad request, invalid parameters or file format
500	free, Internal server error, retry later