Docs/Verificação em Massa

Verificação em Massa

Envie um CSV de endereços de e-mail e receba os resultados da sua lista inteira.

Ver Markdown OpenAPI JSON

Visão geral

A verificação em massa permite verificar milhares de endereços de e-mail em um único job. Envie um arquivo CSV pelo painel ou pela API e baixe os resultados quando o job terminar.

ℹ️
A verificação em massa está disponível pelo painel e pela API. Envie arquivos CSV com POST /api/bulk, consulte GET /api/bulk/{job_id}e depois baixe os resultados em /api/bulk/{job_id}/download.

Upload via API

Envie um upload multipart de CSV com sua chave de API. Opcionalmente, você pode passar email_column quando o campo de e-mail não se chamar email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

Upload pelo Painel

  1. Entre em verimails.com/dashboard
  2. Clique em Verificar em Massa na barra lateral
  3. Envie seu arquivo CSV
  4. Aguarde o job terminar (exibido na sua lista de jobs)
  5. Baixe o CSV de resultados

Formato do CSV

Seu CSV precisa ter uma coluna com endereços de e-mail. O VeriMails detecta automaticamente cabeçalhos comuns como email, Email Address, work_email, e business_email. CSVs de uma coluna sem cabeçalho também são aceitos, mas um cabeçalho de e-mail claro ainda é o melhor:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Colunas adicionais são preservadas na saída e não afetam o processamento.

Formatos aceitos

Formato de saída

O arquivo completo de resultados preserva as colunas originais do CSV e adiciona uma coluna clara de enviabilidade:

Coluna AdicionadaDescrição
Safe to SendYes quando o status verificado é válido; No para resultados inválidos, catch-all, descartáveis, desconhecidos ou arriscados.

Verificando o status do job

No painel, sua lista de jobs mostra o progresso em tempo real. Via API, consulte GET /api/bulk/{job_id} até que o status do job seja completed ou failed.

Notificações por webhook

O suporte a webhook para a conclusão de jobs em massa chega em breve. Veja Webhooks →

💡
Dica: Para montar listas em tempo real, use a API de Verificação Individual para verificar os endereços à medida que você os coleta. A verificação em massa é ideal para limpar listas existentes.