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
Verifique se uma conta de e-mail tem foto de perfil e leia seus atributos de retrato. Cobre Gmail, Yandex e Mail.ru.
POST /api/v1/check
Análise de foto de perfil de e-mailNão é necessário entrar.
Contrato da API
Envie um e-mail e selecione este produto com service_type. A autenticação usa sua chave de API.
Copie o comando curl abaixo e substitua apenas a chave de API de exemplo pela sua.
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"
}
}Como usar
Um número no formato E.164 (um sinal de mais, o código do país e depois o número) para o WhatsApp, ou um e-mail completo para o produto de e-mail.
registered indica se a conta existe (para um endereço de e-mail: se ele é alcançável), avatar indica se há foto de perfil definida e avatar_url traz a imagem. Os três voltam em toda consulta bem-sucedida.
avatar_url aponta para a CDN da própria plataforma e pode expirar no prazo definido por ela. Trate-a como uma referência: baixe ou armazene a imagem em cache se precisar guardá-la.
O que verifica
registered · boolean — Se o endereço de e-mail é alcançável (pode receber mensagens).avatar · boolean — Se há foto de perfil definida.avatar_url · string — URL da foto de perfil; string vazia quando nenhuma foto de perfil está definida.category · string — O que a imagem mostra: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar ou object. unknown quando não foi possível gerar um retrato.age · integer — Idade estimada como número inteiro, com precisão de cerca de 3 anos e limitada a 0-80. Omitida quando não foi possível estimá-la (por exemplo, quando nenhum gênero foi determinado).gender · string — male, female ou unknown.skin_color · string — Tom de pele descritivo, por exemplo white, east_asian ou hispanic. Trate-o como um conjunto aberto; unknown quando não determinado.hair_color · string — Cor do cabelo descritiva, por exemplo black, brown, blond ou gray white. Trate-a como um conjunto aberto; unknown quando não determinada.Ideal para
Adicione o estado da foto de perfil e as URLs das imagens aos contatos de e-mail para que listas de clientes e conversas sejam mais fáceis de reconhecer.
Trate endereços Gmail, Yandex e Mail.ru em um único fluxo e depois grave os dados da foto de perfil nos registros de clientes existentes.
Ao organizar listas de e-mail, distinga a existência da conta, a presença de foto de perfil e se um resultado completo foi retornado, para complementação de dados e revisão manual.
Encontre registros sem foto de perfil, sem resultado claro ou com provedor não compatível para manter as informações dos clientes consistentes.
Resposta direta
Análise de foto de perfil de e-mail retorna se a conta tem foto de perfil e a URL da imagem quando houver. Use o service_type email_profile (o parâmetro que seleciona um produto) com um e-mail, por exemplo alex.kim@gmail.com, e leia os atributos do retrato no nível superior da mesma resposta da API.
Limites claros
Perguntas frequentes do produto
Ela verifica um identificador e retorna se a conta tem foto de perfil e a URL da imagem quando houver na mesma resposta síncrona.
O saldo é cobrado apenas por verificações concluídas. Verificações com falha ou indeterminadas não mantêm a cobrança.
Envie o identificador que o produto aceita: um número no formato E.164 para o WhatsApp, ou um e-mail completo para o produto de e-mail. O formato errado é rejeitado antes de qualquer cobrança.
Não. Ele apenas informa se há foto de perfil definida naquele momento. Não diz nada sobre se a conta está em uso ou online, e não é permissão para contatar ninguém. O consentimento e as regras aplicáveis continuam sendo sua responsabilidade.
Produtos relacionados
Análise de foto de perfil do WhatsAppVerifique se um número tem foto de perfil no WhatsApp, obtenha a URL da imagem e leia os atributos de retrato dessa foto.Crie uma conta para usar todos os produtos pelo painel SaaS ou pela API: verificações em tempo real e verificações em massa assíncronas usam o mesmo saldo.