Solicitação cURL
POST /api/v1/bulk-taskscurl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=email_avatar_batch \
-F file=@emails.txtProduto em massa email_avatar_batch
Verificação de avatar de e-mail em massa
Envie um arquivo inteiro de endereços Gmail, Yandex ou Mail.ru: descubra quais são entregáveis e obtenha o avatar de cada um.
Um complemento para listas grandes inteiras — para poucos e-mails, a verificação em tempo real responde na mesma solicitação. Verificação em tempo real →
Contrato da API
Duas etapas: envie o arquivo e depois consulte a tarefa
O envio retorna um ID de tarefa imediatamente; consulte a tarefa por esse ID e, quando ela for concluída com sucesso, a resposta trará o link de download do arquivo de resultado. Cada solicitação é exibida com a respectiva resposta.
1. Envie o arquivo
O ID da tarefa volta imediatamente com preparing definido como true enquanto o arquivo é preparado em segundo plano: linhas inválidas e duplicadas são removidas e não são cobradas. O saldo é reservado para as linhas enviadas e liquidado na conclusão; a diferença é reembolsada.
Resposta: tarefa criada
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "email_avatar_batch",
"status": "processing",
"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. Consulte a tarefa
Consulte pelo ID da tarefa. Quando a preparação termina, submitted_lines = total + invalid_cnt + duplicate_cnt, em que total é o que é verificado e cobrado; no_code_cnt e other_country_cnt são sempre 0 em tarefas de e-mail. Uma resposta de sucesso traz as contagens de sucesso e de falha e o link de download do arquivo de resultado; uma tarefa recusada durante a preparação fica como failed com reason_detail e é reembolsada integralmente.
Solicitação cURL
GET /api/v1/bulk-tasks/{id}curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Resposta: tarefa concluída
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "email_avatar_batch",
"status": "success",
"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"
}
}Como funciona
O que acontece com uma tarefa em massa
A verificação em massa não é a verificação em tempo real em escala maior — você envia uma vez, ela roda em segundo plano e você coleta depois. Não é preciso manter a página aberta; o estado da tarefa e os resultados ficam no seu painel.
01Envie o arquivo
Um .txt ou .csv com um e-mail por linha. Ele é transmitido diretamente; nada é gravado em disco.
02Pré-verificação e reserva
Problemas óbvios (arquivo vazio, formato errado, poucas linhas) são rejeitados no envio. Em seguida, o saldo é reservado e o arquivo é preparado em segundo plano: linhas duplicadas e inválidas são removidas e a cobertura de provedores é verificada. Um arquivo que falha nessa etapa termina como tarefa com falha, reembolsada integralmente; caso contrário, apenas as linhas restantes são verificadas, e a tarefa é liquidada ao ser concluída.
03Execução em segundo plano
A tarefa é executada sozinha — feche a página se quiser. Uma falha é informada imediatamente e reembolsada integralmente.
04Baixe o resultado
Retire o arquivo na página de verificação em massa. Você paga apenas pelos e-mails que efetivamente retornaram resultado; a diferença é reembolsada.
Campos do resultado
Colunas do arquivo de resultado
O download é um único arquivo CSV contendo esta tabela completa.
Colunas do arquivo de resultado
identifier·alex.kim@gmail.com— O endereço enviado, em letras minúsculas.activated·true— Se o endereço é entregável nesse provedor — se pode receber mensagens: true ou false. Quando não for true, todas as outras colunas dessa linha ficam vazias.avatar·true— Se há um avatar definido: true ou false. avatar_url ainda pode vir vazia quando a imagem não estiver disponível.avatar_url·https://lh3.googleusercontent.com/a/example— A URL da foto de perfil; vazia quando nenhuma URL está disponível.
Ideal para
Quando recorrer a este produto
Enriquecimento de contatos
activatedavatar_urlDepois de confirmar que um endereço pode receber mensagens, adicione o link público do avatar ao registro do contato para facilitar o reconhecimento.
Por exemplo: enriquecer contatos do Gmail já armazenados em um CRM de vendas.
Higiene da base de dados
identifieractivatedavatarSinalize endereços não entregáveis e registros sem avatar para que possam ser limpos, mesclados ou revisados depois.
Por exemplo: remover endereços com falha e depois revisar contatos válidos com perfis incompletos.
Reverificações periódicas
activatedavataravatar_urlExecute novamente uma lista armazenada periodicamente para ver se a entregabilidade ou o avatar público mudou.
Por exemplo: atualizar os dados de avatar de contatos de alto valor a cada trimestre.
Resposta direta
O que é a Verificação de foto de perfil em massa?
A verificação de avatar em massa é a versão em arquivo da verificação de avatar em tempo real (email_avatar) e cobre os domínios do Gmail, Yandex e Mail.ru. Misture-os livremente em um único arquivo; cada endereço é roteado para você. Para cada endereço, ela retorna se é entregável, se há um avatar definido e a URL do avatar. Um arquivo com endereços fora dessa lista falha durante a preparação e é reembolsado integralmente.
Limites claros
Limites deste produto
- Não é verificação de identidade. Um resultado diz se o endereço pode receber mensagens; não confirma quem é o dono.
- Nunca retorna histórico de mensagens, conteúdo de conversas nem qualquer conteúdo privado da conta.
- A verificação de avatar cobre os domínios do Gmail, Yandex e Mail.ru. Misture os três livremente em um único arquivo; endereços fora dessa lista fazem a tarefa falhar com uma contagem, com reembolso integral. A verificação de entregabilidade aceita qualquer domínio.
- Os resultados refletem o momento em que a tarefa foi executada. Execute-a novamente para obter um estado atualizado — os resultados armazenados nunca são atualizados automaticamente.
- Os links de download expiram. Baixe o arquivo logo após o término da tarefa; se um link expirar, consulte a tarefa novamente para obter um novo.
Quando a verificação em massa se encaixa
Quando a verificação em massa vale a pena — e quando a em tempo real é mais rápida
| Verificação em tempo real | Verificação em massa | |
|---|---|---|
| Quantos e-mails | 1 e-mail por verificação única; vários por solicitação múltipla — os limites exatos estão na documentação da API | Uma lista grande inteira em uma única tarefa — a faixa de tamanho atual está na página de preços |
| Obtenção dos resultados | Imediata: os endpoints único e múltiplo respondem na mesma resposta; o painel os retorna um a um | Baixe um arquivo de resultado quando a tarefa terminar |
| Cobertura de provedores | Sem restrição — misture à vontade em uma única solicitação | A verificação de endereço completo aceita qualquer domínio em um único arquivo; a verificação de avatar aceita Gmail, Yandex e Mail.ru misturados em um único arquivo, e nada fora desses três |
| Formato do resultado | JSON, campos por e-mail | Arquivo de resultado (um CSV com a tabela completa) |
| Uso típico | Validação de formulários, consultas de atendentes, bloqueio antes do envio | Higienização de listas, filtragem antes de campanhas, limpeza de dados armazenados |
Perguntas frequentes do produto
Sobre a Verificação de foto de perfil
Quando devo usar a verificação em massa em vez da verificação em tempo real?
Use a verificação em massa para uma lista grande inteira. Para poucos e-mails, a verificação em tempo real responde na mesma solicitação, sem tarefa para agendar.
O que acontece com os e-mails inválidos do arquivo?
A pré-verificação descarta as linhas malformadas, então elas nunca entram na contagem cobrável. Dos e-mails restantes, os que o serviço de origem não consegue resolver também não são cobrados. Você paga apenas pelos e-mails que efetivamente retornam resultado.
Quanto tempo leva uma tarefa?
Depende da quantidade de e-mails e do produto. Você pode fechar a página depois de enviar; a tarefa é executada em segundo plano e o resultado fica à sua espera na página de verificação em massa.
Sou reembolsado se falhar?
Sim. Uma tarefa com falha é reembolsada integralmente. Se a tarefa for bem-sucedida, mas alguns e-mails não retornarem nada, essa parte é reembolsada automaticamente. A diferença entre o valor reservado e o valor efetivamente cobrado sempre é devolvida.
Produtos relacionados
Outros produtos em massa
Crie uma conta para enviar uma tarefa em massa
As verificações em massa e em tempo real usam o mesmo saldo — não há nada extra para ativar. Cadastre-se e envie seu primeiro arquivo na página de verificação em massa.