Perfil de usuario de Telegram

task_type=tg_username_profile

Entrada y límites

nombres de usuario de Telegram. Sube un archivo de texto con un valor por línea. Procesa solo identificadores autorizados.

Carga mínima: 500. Carga máxima: 10,000,000. Cantidad mínima facturable: 0. El mínimo de carga es distinto del de facturación. Una carga pequeña aceptada puede facturarse al mínimo. Cero indica que no hay mínimo facturable. Una tarea totalmente fallida o sin procesar no genera un mínimo artificial. Consulta los precios actuales de tu cuenta.

Crear una tarea

curl --request POST 'https://api.numberchecker.ai/v1/tasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'file=@input.txt' \
  --form 'task_type=tg_username_profile'

Consultar y descargar

Guarda el task_id recibido. Consulta hasta status=exported y descarga result_url. pending y processing no son resultados finales; detente en failed. No repitas automáticamente la creación tras un tiempo de espera: la tarea podría existir.

curl --request POST 'https://api.numberchecker.ai/v1/gettasks' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'task_id=YOUR_TASK_ID'

Columnas CSV

username,activated,avatar_url,uid,lastseen,activedays,member,category,gender,hair_color,skin_color,age

Conserva el orden y las mayúsculas. Los valores vacíos o indeterminados no confirman un resultado negativo.

El perfil requiere un avatar público. Sin él, el proceso termina tras comprobar el registro; los campos posteriores pueden quedar vacíos. Los atributos derivados del avatar son estimaciones. Profile es distinto de Activity; Full está retirado. No sustituyas tipos de tarea automáticamente.

Autenticación y errores

Usa X-API-Key con una clave del servidor. 400: entrada inválida; 401: clave inválida; 402: saldo insuficiente; 404: tarea inexistente; 413: archivo demasiado grande. Reintenta consultas seguras con espera limitada y conserva el ID.

Precios actuales

Contrato revisado: 2026-10-30. Los límites pueden cambiar; consulta el panel antes de enviar.