AvatarLookup

Producto masivo tg_profile_batch

Perfil de números de Telegram · Masivo

Suba números: ID de usuario de Telegram, nombre de usuario, días de actividad y URL del avatar, además de la edad, el género y el tono de piel reconocidos en el avatar.

Un complemento para listas grandes completas: para unos pocos identificadores, la verificación en tiempo real responde en la misma solicitud. Verificación en tiempo real →

Ver el contrato de la APIRegistrarse

Contrato de la API

Dos pasos: enviar el archivo y consultar la tarea

Leer la documentación completa de la API Abrir claves API

Al enviar se devuelve de inmediato un ID de tarea; consulte la tarea con ese ID y, cuando se complete correctamente, la respuesta incluirá el enlace de descarga del archivo de resultados. Cada solicitud se muestra con su propia respuesta.

1. Enviar el archivo

El ID de tarea se devuelve de inmediato con preparing en true mientras el archivo se prepara en segundo plano: se eliminan las líneas no válidas, los duplicados y, en las tareas de números, los números sin código de país o de otro país, que no se cobran. El saldo se reserva para las líneas enviadas y se liquida al completarse; la diferencia se reembolsa.

Solicitud cURLPOST /api/v1/bulk-tasks
curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_profile_batch \
  -F country=US \
  -F file=@numbers.txt
Respuesta: tarea creada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Consultar la tarea

Sondee por ID de tarea. Cuando finaliza la preparación, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, donde total es lo que se verifica y se cobra. Una respuesta correcta incluye los recuentos de éxitos y fallos y el enlace de descarga del archivo de resultados; una tarea rechazada durante la preparación queda en failed con reason_detail y se reembolsa íntegramente.

Solicitud cURLGET /api/v1/bulk-tasks/{id}
curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Respuesta: tarea finalizada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Cómo se ejecuta

Qué ocurre con una tarea masiva

El modo masivo no es una versión ampliada del tiempo real: se envía una vez, se ejecuta en segundo plano y se recoge más tarde. No necesita mantener la página abierta; el estado de la tarea y los resultados permanecen en su panel.

  1. 01Suba el archivo

    Un archivo .txt o .csv con un número por línea. Se transmite directamente; no se escribe nada en disco.

  2. 02Comprobación previa y reserva

    Los problemas evidentes (un archivo vacío, un formato incorrecto, muy pocas líneas) se rechazan al subir el archivo. Después se reserva el saldo y el archivo se prepara en segundo plano: se eliminan las líneas duplicadas y no válidas y se comprueba la regla del país. Un archivo que falla en ese punto termina como tarea fallida y se reembolsa íntegramente; en caso contrario, solo se verifican las líneas restantes y la tarea se liquida al finalizar.

  3. 03Ejecución en segundo plano

    La tarea se ejecuta por sí sola: puede cerrar la página si lo desea. Un fallo se notifica de inmediato y se reembolsa íntegramente.

  4. 04Descargue el resultado

    Recoja el archivo en la página de verificación masiva. Solo paga por las entradas que realmente devolvieron un resultado; la diferencia se reembolsa.

Campos del resultado

Columnas del archivo de resultados

La descarga es un único archivo CSV con la tabla de resultados completa.

Columnas del archivo de resultados

  • identifier · 17253100591 — El número enviado como dígitos sin formato con el código de país, sin signo más ni espacios (p. ej., 17253100591).
  • activated · true — Si el número está registrado en Telegram: true o false. Cuando no es true, todas las demás columnas de esa fila quedan vacías.
  • uid · 1234567890 — ID de usuario de Telegram.
  • username · alex_kim — Nombre de usuario; vacío cuando la cuenta no tiene.
  • activedays · 9 — Días desde la última vez que se vio la cuenta, como número entero; cuanto menor, más reciente. Cuando la cuenta oculta su hora exacta de última conexión, Telegram solo revela un intervalo y el valor es una aproximación: 0 (recientemente), 7 (en la última semana), 30 (en el último mes) o 1000 (hace mucho tiempo).
  • avatar_url · https://telegram.waavatar.xyz/v/example.jpg — URL del avatar; vacía cuando la cuenta no tiene avatar.
  • age · 31 — Edad estimada a partir del avatar; vacía cuando no se puede estimar.
  • gender · male — Género estimado a partir del avatar: male o female; unknown cuando no se puede reconocer y vacío cuando no hay avatar.
  • skin_color · white — Tono de piel estimado a partir del avatar, p. ej. white, asian, east_asian; unknown cuando no se puede reconocer y vacío cuando no hay avatar.

Ideal para

Cuándo recurrir a este producto

Segmentación de listas

activatedactivedaysavatar_url

Agrupe los números de Telegram por resultado de cuenta, actividad reciente y disponibilidad de avatar antes de una campaña de contacto o de revisar la lista.

Ejemplo: priorice las cuentas activas con avatar utilizable para las operaciones de contacto.

Enriquecimiento de datos de contacto

uidusernameavatar_url

Añada los ID de Telegram, los nombres de usuario y los enlaces de avatar a los contactos existentes para que los equipos reconozcan y eliminen duplicados más rápido.

Ejemplo: convierta una lista de teléfonos sin procesar en una tabla de perfiles lista para contactar.

Revisión de audiencias

activedaysagegender

Mantenga la actividad y los atributos basados en el avatar en un único archivo de resultados para organizar audiencias y revisarlas manualmente.

Ejemplo: separe las cuentas con actividad reciente de los perfiles inactivos o incompletos.

Controles de calidad de perfiles

avatar_urlagegenderskin_color

Use el avatar y sus atributos estimados para identificar los registros que requieren enriquecimiento, verificación o un tratamiento cuidadoso.

Ejemplo: marque para seguimiento las cuentas con número registrado pero sin avatar utilizable.

Respuesta directa

¿Qué es la Perfil de números de Telegram masiva?

La consulta masiva de avatares de Telegram devuelve, para cada número registrado, el ID de usuario, el nombre de usuario, los días de actividad, la URL del avatar y los atributos reconocidos en él: edad, género y tono de piel. Elija el país al que pertenecen los números al subir el archivo.

Límites claros

Límites de este producto

  • Los resultados reflejan el momento en que se ejecutó la tarea. Los avatares cambian: vuelva a ejecutarla para obtener un estado actualizado; los resultados guardados nunca se actualizan automáticamente.
  • No es una verificación de accesibilidad ni de actividad, ni una verificación de identidad.
  • No se envía nada a los identificadores del archivo.
  • Las columnas que se devuelven dependen de la plataforma. Se indican en esta página antes de que suba el archivo.
  • Los enlaces de descarga caducan. Obtenga el archivo poco después de que termine la tarea; si un enlace caduca, vuelva a consultar la tarea para obtener uno nuevo.

Cuándo encaja el modo masivo

Cuándo merece la pena el modo masivo y cuándo es más rápido el tiempo real

Verificación en tiempo realVerificación masiva
Cuántos identificadores1 identificador por verificación individual; varios por solicitud múltiple (los límites exactos figuran en la documentación de la API)Una lista grande completa en una sola tarea: el intervalo de tamaño actual figura en la página de precios
Obtención de resultadosDe inmediato: el endpoint individual y el múltiple responden en la misma respuesta; el panel los devuelve uno a unoDescargue un archivo de resultados cuando termine la tarea
PaísNo hay que elegirlo: las consultas en tiempo real se envían de una en una, no agrupadas por paísUn país por tarea, seleccionado al subir el archivo y enviado con él
Formato del resultadoJSON, campos por elementoArchivo de resultados (un CSV con la tabla completa)
Uso habitualValidación de formularios, consultas de agentes, filtrado previo al envíoDepuración de listas, filtrado previo a campañas, limpieza de datos almacenados

Verificación en tiempo real · Ver precios

Preguntas frecuentes del producto

Acerca de Perfil de números de Telegram

¿Cuándo debo usar el modo masivo en lugar de una verificación en tiempo real?

Use el modo masivo para una lista grande completa. Para unos pocos identificadores, la verificación en tiempo real responde en la misma solicitud, sin tareas que programar.

¿Qué ocurre con los identificadores no válidos del archivo?

La comprobación previa descarta las líneas mal formadas, por lo que nunca entran en el recuento facturable. De los números restantes, tampoco se cobran los que el servicio de origen no pueda resolver. Solo paga por los números que realmente devuelven un resultado.

¿Cuánto tarda una tarea?

Depende del número de entradas y del producto. Puede cerrar la página después de enviarla; la tarea se ejecuta en segundo plano y el resultado le espera en la página de verificación masiva.

¿Se me reembolsa si falla?

Sí. Una tarea fallida se reembolsa íntegramente. Si la tarea se completa pero algunas entradas no devuelven nada, esa parte se reembolsa automáticamente. La diferencia entre el importe reservado y lo realmente cobrado siempre se devuelve.

Productos relacionados

Otros productos masivos

Análisis de avatares de WhatsApp · MasivoSuba un archivo completo de números: URL del avatar de WhatsApp y lo que muestra el avatar (categoría, edad, género, tono de piel y color de cabello).Perfil de nombres de usuario de Telegram · MasivoSuba nombres de usuario de Telegram: ID de usuario, días de actividad y URL del avatar de cada cuenta.Perfil de números de Viber · MasivoSuba números: ID de miembro de Viber, días de actividad y URL del avatar, además de la categoría, la edad, el género y el tono de piel reconocidos en el avatar.Perfil de números de MAX · MasivoSuba números: ID de usuario de MAX, URL del avatar y género.Análisis de avatares de LINE · MasivoSuba números: ID de usuario de LINE y URL del avatar, además de la categoría, la edad, el género, el tono de piel y el color de cabello reconocidos en el avatar.Perfil de números de Zalo · MasivoSuba números: ID de usuario de Zalo y URL del avatar, además de la categoría, la edad, el género y el tono de piel reconocidos en el avatar.Verificación de avatares de email · MasivoSuba direcciones de Gmail, Yandex o Mail.ru: si cada una admite entrega y su avatar.

Cree una cuenta para enviar una tarea masiva

Las verificaciones masivas y en tiempo real consumen el mismo saldo: no hay nada adicional que activar. Regístrese y suba su primer archivo en la página de verificación masiva.

Registrarse Ver precios