AvatarLookup

Producto masivo zalo_profile_batch

Perfil de números de Zalo · Masivo

Suba 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.

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=zalo_profile_batch \
  -F country=US \
  -F file=@numbers.txt
Respuesta: tarea creada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "zalo_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": "zalo_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 Zalo: true o false. Cuando no es true, todas las demás columnas de esa fila quedan vacías.
  • uid · 452114152 — ID de usuario de Zalo.
  • avatar_url · https://s160-ava-talk.zadn.vn/example.jpg — URL del avatar; vacía cuando la cuenta no tiene avatar.
  • category · individual portrait — Qué muestra el avatar: individual portrait, group photo, cartoon avatar, pet avatar, landscape, object, etc.; unknown cuando no se puede reconocer y vacío cuando no hay 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 · asian — 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

activatedcategory

Organice las listas de números de Zalo por resultado de cuenta y lo que muestra el avatar.

Ejemplo: separe los retratos individuales de las fotos de grupo para distintos flujos de trabajo.

Enriquecimiento de datos de contacto

uidavatar_url

Escriba los ID de cuenta y los enlaces de avatar en los contactos existentes para reducir la introducción manual y el trabajo duplicado.

Ejemplo: haga reconocible una importación de números de teléfono antes de que llegue a una cola de ventas.

Revisión de audiencias

genderageskin_color

Use los atributos de apariencia como señales descriptivas de revisión para conocer la composición de los registros almacenados, no como afirmaciones de identidad.

Ejemplo: resuma una lista para su revisión manual manteniendo las estimaciones claramente etiquetadas.

Completitud de perfiles

activatedavatar_urlcategory

Detecte las cuentas sin avatar utilizable o con una imagen no reconocida para que los equipos puedan elegir un valor predeterminado seguro o solicitar una verificación manual.

Ejemplo: excluya los perfiles incompletos de una exportación de enriquecimiento automatizada.

Respuesta directa

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

La consulta masiva de avatares de Zalo devuelve, para cada número registrado, el ID de usuario de Zalo, la URL del avatar y los atributos reconocidos en él: categoría, edad, género y tono de piel. Las cuentas que siguen usando la imagen predeterminada de Zalo se consideran sin avatar. 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 Zalo

¿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 números de Telegram · MasivoSuba 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.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.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