Verificar uma lista

Uma lista de verificação confere muitos endereços de uma só vez, por exemplo antes de importar contatos de outro sistema ou de enviar uma campanha para uma lista antiga. Este guia mostra como criar uma lista, acompanhar o progresso, ler os resultados e exportá-los.

Antes de começar

• Uma lista pode conter até 10.000 endereços. Divida arquivos maiores em várias listas.
• Cada endereço único custa 5 créditos, cobrados quando você cria a lista. Uma lista de 10.000 endereços precisa de 50.000 créditos.
• As listas sempre usam o modo full, que inclui a verificação da caixa de e-mail. Consulte Modos fast e full.
• Para a API, use uma chave de API com Full Access.

Criar uma lista

curl https://api.emailit.com/v2/email-verification-lists \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter import October",
    "emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
  }'

{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}

Antes de cobrar, o Emailit limpa a entrada: converte todos os endereços para minúsculas, remove as duplicatas e descarta as entradas sem @. Você só é cobrado pelos endereços únicos que restarem. Se a lista não puder ser iniciada, os créditos são devolvidos.

Acompanhar o progresso

O status da lista passa por estas etapas:

Em Email Verification›Lists, a coluna Statistics mostra as contagens Total, Pending, Successful e Failed de cada lista. A coluna Expiring mostra quantos dias faltam até a lista ser excluída.

Pela API, chame Obter uma lista e leia status e stats. Para não precisar consultar periodicamente, inscreva um webhook em email_verification_list.updated, que é disparado quando a lista é concluída. Cada endereço também dispara email_verification.updated quando o resultado dele fica pronto.

Revisar os resultados

Selecione uma lista no painel para abri-la. A página mostra:

• cards com Created, Status, Total Emails, Pending, Successful e Failed,
• gráficos de Verification Status Progress, Verification Results Breakdown e Risk Levels,
• uma tabela com todos os endereços, com status, resultado, risco e pontuação.

Pela API, chame Listar resultados. Filtre por result ou status e pagine com page e limit (padrão 50):

curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"

Cada item tem id, email, status, result, score, risk e mx_records do endereço. Resultados da verificação explica cada valor e o que fazer com ele.

Exportar os resultados

Quando uma lista estiver completed, você pode baixar todos os resultados dela como um arquivo do Excel.

curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx

O arquivo tem uma linha por endereço, com status, resultado, pontuação e risco, cada verificação individual (sintaxe válida, descartável, endereço genérico, caixa cheia, entregável, desativado, e-mail gratuito, aleatório, catch-all, conexão SMTP, registros MX), as partes do endereço, a idade do domínio, a sugestão did_you_mean e os registros MX. Os resultados têm cores diferentes para você analisá-los rapidamente.

Usar os resultados

1. Remova os endereços com o resultado invalid, disabled ou disposable antes de importar ou enviar.
2. Revise os endereços inbox_full, role e unknown. Mantenha-os se tiver um motivo para isso, mas acompanhe os bounces deles.
3. Importe o restante para os seus contatos ou para uma lista de contatos.

Consulte Ações recomendadas para cada resultado.

Veja também