POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "email_profile", "identifier": "alex.kim@gmail.com" }'
service_type email_profile
Compruebe si una cuenta de email tiene avatar y lea sus atributos de retrato. Cubre Gmail, Yandex y Mail.ru.
POST /api/v1/check
Análisis de avatares de emailNo es necesario iniciar sesión.
Contrato de la API
Envíe un email y seleccione este producto con service_type. La autenticación usa su clave API.
Copie el siguiente comando curl y sustituya únicamente la clave API de ejemplo por la suya.
POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "email_profile", "identifier": "alex.kim@gmail.com" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "email_profile",
"identifier": "alex.kim@gmail.com",
"registered": true,
"avatar": true,
"avatar_url": "https://lh3.googleusercontent.com/a/example",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Cómo usarlo
Un número en formato E.164 (un signo más, el código de país y después el número) para WhatsApp, o un email completo para el producto de email.
registered indica si la cuenta existe (para una dirección de email: si es accesible), avatar indica si hay un avatar configurado y avatar_url contiene la imagen. Los tres se devuelven en cada consulta correcta.
avatar_url apunta a la propia CDN de la plataforma y puede caducar según sus plazos. Trátela como una referencia: descargue o almacene en caché la imagen si necesita conservarla.
Qué verifica
registered · boolean — Si la dirección de email es accesible (puede recibir correo).avatar · boolean — Si hay un avatar configurado.avatar_url · string — URL del avatar; cadena vacía cuando no hay ningún avatar configurado.category · string — Qué es la imagen: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar o object. unknown cuando no se ha podido obtener un retrato.age · integer — Edad estimada como número entero, con una precisión de unos 3 años y limitada al rango 0-80. Se omite cuando no se ha podido estimar (por ejemplo, cuando no se determinó el género).gender · string — male, female o unknown.skin_color · string — Tono de piel descriptivo, por ejemplo white, east_asian o hispanic. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.hair_color · string — Color de cabello descriptivo, por ejemplo black, brown, blond o gray white. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.Ideal para
Añada el estado del avatar y las URL de imagen a los contactos de email para que las listas de clientes y las conversaciones sean más fáciles de reconocer.
Gestione las direcciones de Gmail, Yandex y Mail.ru en un solo flujo de trabajo y escriba después los datos del avatar en los registros de clientes existentes.
Al organizar listas de email, distinga la existencia de la cuenta, la presencia de avatar y si se devolvió un resultado completo, para completar los datos y para la revisión manual.
Encuentre los registros sin avatar, sin un resultado claro o con un proveedor no compatible para que la información de los clientes siga siendo coherente.
Respuesta directa
Análisis de avatares de email devuelve si la cuenta tiene avatar y la URL de la imagen cuando lo tiene. Use el service_type email_profile (el parámetro que selecciona un producto) con un email, por ejemplo alex.kim@gmail.com, y lea los atributos de retrato en el nivel superior de la misma respuesta de la API.
Límites claros
Preguntas frecuentes del producto
Verifica un identificador y devuelve si la cuenta tiene avatar y la URL de la imagen cuando lo tiene en la misma respuesta síncrona.
El saldo solo se cobra por las verificaciones completadas. En las verificaciones fallidas o indeterminadas no se mantiene el cargo.
Envíe el identificador que acepta el producto: un número en formato E.164 para WhatsApp o un email completo para el producto de email. Un formato incorrecto se rechaza antes de cualquier cargo.
No. Solo informa de si hay un avatar configurado en ese momento. No dice nada sobre si la cuenta está en uso o en línea, y no constituye un permiso para contactar con nadie. El consentimiento y las normas aplicables siguen siendo su responsabilidad.
Productos relacionados
Análisis de avatares de WhatsAppCompruebe si un número tiene avatar de WhatsApp, obtenga la URL de la imagen y lea los atributos de retrato de ese avatar.Cree una cuenta para usar todos los productos desde el panel SaaS o la API: las verificaciones en tiempo real y las verificaciones masivas asíncronas consumen el mismo saldo.