Telegram Profile Checker API: Comprobación masiva

Comprueba el registro en Telegram y devuelve nombre, nombre de usuario, ID de usuario, foto de perfil, última conexión, días desde la última vez en línea, estado Premium y edad, género y etnia estimados por IA. Combina el filtrado por actividad y por perfil. La tarea utiliza el flujo de trabajo estándar de procesamiento por lotes asíncrono.

Formato de entrada

Cargue un archivo de texto con un número de teléfono por línea. Normalice los valores antes de cargarlo; se recomienda el formato E.164 para teléfonos.

+14155552671
+442071838750

Crear una tarea

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="tg_avatar"'

La API devuelve un ID de tarea. Guárdelo y úselo para consultar el estado.

Respuesta de carga

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Comprobar el estado de la tarea

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Consulte hasta que status sea exported. No considere pending ni processing como resultados completos.

Respuesta en proceso

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Respuesta exportada

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Campos del resultado

Campo	Descripción	Ejemplo
Phone	Número de teléfono de la entrada enviada.	+14155552671
activated	Indica si la entrada se detectó como activa o registrada.	yes
uid	Campo de resultado devuelto: uid.	valor de ejemplo
username	Nombre de usuario de entrada del archivo enviado.	example_user
Gender	Campo de resultado devuelto: Gender.	valor de ejemplo
Age	Campo de resultado devuelto: Age.	valor de ejemplo
Ethnicity	Campo de resultado devuelto: Ethnicity.	valor de ejemplo
Avatar	Campo de resultado devuelto: Avatar.	valor de ejemplo
Last Online Time	Campo de resultado devuelto: Last Online Time.	valor de ejemplo
Active Days	Campo de resultado devuelto: Active Days.	valor de ejemplo
Is Member	Campo de resultado devuelto: Is Member.	valor de ejemplo
first_name	Campo de resultado devuelto: first_name.	valor de ejemplo
last_name	Campo de resultado devuelto: last_name.	valor de ejemplo

Procesamiento del archivo de resultados

Descargue el archivo desde result_url solo después de exportar la tarea. Conserve los nombres de columna devueltos al procesar el archivo.

Campos de respuesta

Campo	Descripción
created_at	Marca de tiempo de creación de la tarea.
updated_at	Marca de tiempo de la última actualización.
task_id	Identificador único de la tarea.
status	pending, processing, exported o failed.
total	Total de valores de entrada procesados.
success	Valores procesados correctamente.
failure	Valores cuyo procesamiento falló.
result_url	URL de descarga cuando la tarea se exporta.
actual_amount	Importe final liquidado, si está disponible.
estimated_amount	Importe estimado devuelto al crear la tarea.

Códigos de estado

Status	Descripción
200	Solicitud correcta.
202	Tarea creada correctamente y cargo estimado aplicado.
400	Archivo no válido, tipo de tarea no compatible o muy pocas entradas válidas.
401	Falta la clave API o no es válida.
402	Saldo insuficiente.
403	Producto no disponible para su cuenta (descontinuado o solo para clientes en lista blanca); contacte con soporte.
404	Tarea no encontrada.
413	El archivo cargado es demasiado grande.
500	Error interno del servidor; inténtelo más tarde.
503	Producto temporalmente no disponible (pausado por mantenimiento); no se realiza ningún cargo, inténtelo más tarde.

Notas operativas

• La tarea es asíncrona; use el ID para consultar su estado.
• Compruebe los límites de entrada del producto antes de cargar el archivo.
• Las filas fallidas aparecen en el resultado exportado y se reflejan en los contadores.
• Los campos anteriores se basan en el sample actual y pueden cambiar si cambia el esquema de exportación.