Como o AvatarLookup verifica a foto de perfil de uma conta

Conclua uma consulta

Esta seção aborda os produtos em tempo real: o painel e os endpoints REST síncronos compartilham um único serviço de consulta e o mesmo significado de resposta. Listas inteiras passam pela opção em massa assíncrona, abordada no final desta página.

1. 1

   Escolha a fonte

   service_type=ws_profile recebe um número. service_type=email_profile recebe um e-mail e cobre Gmail, Yandex e Mail.ru em um único produto.

2. 2

   Envie um identificador

   Um por solicitação, ou até 100 em uma única solicitação múltipla síncrona. O lote inteiro compartilha um único service_type.

3. 3

   Leia três campos

   registered, avatar e avatar_url. Faça uma nova consulta quando precisar do estado atual — fotos de perfil mudam.

Qual formato de identificador enviar

Cada produto aceita exatamente um formato de identificador. O formato errado é rejeitado antes de qualquer cobrança.

• WhatsApp: um número no formato E.164 — um sinal de mais, o código do país e depois o número do assinante, sem espaços nem separadores.
• E-mail: um endereço completo. Somente os domínios Gmail, Yandex e Mail.ru são aceitos; qualquer outro domínio é rejeitado antes da cobrança, porque nenhum provedor upstream o cobre.
• Formatos de número nacionais com zeros iniciais, espaços, hifens ou parênteses não são aceitos. Um formato rejeitado não é um resultado “sem foto de perfil”.

O que significam os três campos?

Eles respondem a três perguntas diferentes e não devem ser reduzidos a uma só. Uma conta que não existe não pode ter foto de perfil, mas uma conta que existe pode não ter nenhuma — são resultados diferentes e cobrados da mesma forma.

• registered — se o identificador tem uma conta nessa plataforma.
• avatar — se essa conta tem foto de perfil definida. False é um resultado, não uma falha.
• avatar_url — o endereço da imagem quando avatar é true; caso contrário, uma string vazia. Aponta para a CDN da própria plataforma e pode expirar no prazo definido por ela; trate-a como uma referência, não como um arquivo.

Use o resultado dentro do seu escopo

Uma consulta reflete o estado no momento da solicitação. Não é verificação de identidade nem permissão para contatar alguém.

• Uma foto de perfil não confirma quem é o titular da conta, se ela está em uso nem se alguém a está lendo.
• Fotos de perfil são adicionadas, alteradas e removidas a qualquer momento. Um resultado armazenado no mês passado é um registro daquele momento, não de hoje.
• Nada é enviado à conta consultada.

Listas inteiras: a opção assíncrona

O endpoint múltiplo em tempo real cobre a maioria das listas. Além disso, envie o arquivo inteiro como uma única tarefa em massa assíncrona — essa também é a única forma de alcançar as plataformas sem produto em tempo real (Telegram, Viber, LINE, MAX, Zalo).

• Envie um .txt ou .csv com um identificador por linha, pela página de verificação em massa ou pela API.
• Os produtos de número de telefone exigem escolher o país no envio; os produtos de nome de usuário e de e-mail, não.
• O saldo das linhas válidas é reservado no envio, você só é cobrado pelos identificadores que retornam resultado e a diferença é reembolsada.
• A tarefa é executada em segundo plano; baixe o CSV de resultado quando terminar. Uma tarefa com falha é reembolsada integralmente.