Cómo comprueba AvatarLookup el avatar de una cuenta

Realice una consulta

Esta sección trata los productos en tiempo real: el panel y los endpoints REST síncronos comparten un mismo servicio de consulta y un mismo significado de respuesta. Las listas completas se procesan mediante la opción masiva asíncrona, descrita al final de esta página.

1. 1

   Elija la fuente

   service_type=ws_profile recibe un número. service_type=email_profile recibe un email y cubre Gmail, Yandex y Mail.ru en un solo producto.

2. 2

   Envíe un identificador

   Uno por solicitud, o hasta 100 en una solicitud múltiple síncrona. Todo el lote comparte un único service_type.

3. 3

   Lea tres campos

   registered, avatar y avatar_url. Realice una nueva consulta cuando necesite un estado actual: los avatares cambian.

Qué formato de identificador enviar

Cada producto acepta exactamente un formato de identificador. Un formato incorrecto se rechaza antes de cualquier cargo.

• WhatsApp: un número en formato E.164, es decir, un signo más, el código de país y después el número de abonado, sin espacios ni separadores.
• Email: una dirección completa. Solo se aceptan los dominios de Gmail, Yandex y Mail.ru; cualquier otro dominio se rechaza antes de cobrarse, porque ningún proveedor de origen lo cubre.
• No se aceptan formatos de número nacionales con ceros iniciales, espacios, guiones o paréntesis. Un formato rechazado no es un resultado «sin avatar».

¿Qué significan los tres campos?

Responden a tres preguntas distintas y no deben fundirse en una sola. Una cuenta que no existe no puede tener avatar, pero una cuenta que sí existe puede no tenerlo: son resultados distintos y se cobran igual.

• registered: si el identificador tiene una cuenta en esa plataforma.
• avatar: si esa cuenta tiene un avatar configurado. False es un resultado, no un fallo.
• avatar_url: la dirección de la imagen cuando avatar es true y una cadena vacía en caso contrario. Apunta a la propia CDN de la plataforma y puede caducar según sus plazos, así que trátela como una referencia y no como un archivo.

Use el resultado dentro de su alcance

Una consulta refleja el estado en el momento de la solicitud. No es una verificación de identidad ni un permiso para contactar con alguien.

• Un avatar no confirma quién es el titular de la cuenta, si está en uso ni si alguien la lee.
• Los avatares se añaden, cambian y eliminan en cualquier momento. Un resultado guardado el mes pasado es un registro de ese momento, no de hoy.
• No se envía nada a la cuenta consultada.

Listas completas: la opción asíncrona

El endpoint múltiple en tiempo real cubre la mayoría de las listas. Más allá de eso, envíe el archivo completo como una tarea masiva asíncrona; es también la única forma de acceder a las plataformas sin producto en tiempo real (Telegram, Viber, LINE, MAX, Zalo).

• Suba un .txt o .csv con un identificador por línea, desde la página de verificación masiva o a través de la API.
• Los productos de números de teléfono requieren elegir el país al subir el archivo; los de nombre de usuario y de email, no.
• Al enviar se reserva saldo para las líneas válidas, solo se cobran los identificadores que devuelven un resultado y la diferencia se reembolsa.
• La tarea se ejecuta en segundo plano; descargue el CSV de resultados cuando finalice. Una tarea fallida se reembolsa íntegramente.