Atualizado em 15 de novembro de 2026
Uma API para validar e-mail recebe um endereço, confere a sintaxe, o domínio, os registros MX e o servidor SMTP e devolve o resultado em 1 a 2 segundos, sem enviar nenhuma mensagem ao destinatário. Na API do VerificarEmails, o resultado é seguro, inválido, arriscado ou desconhecido. Você a usa em formulários, no CRM e em importações de listas.
Este guia explica a diferença entre uma API de validação e uma API de envio, quando usar a validação, o que cada resultado significa, como integrar a API passo a passo e como evitar bloquear clientes reais por engano. Endpoints, parâmetros e formato da resposta estão na documentação da API.
Qual é a diferença entre uma API de envio e uma API de validação de e-mail?
Uma API de envio, via SMTP ou transacional, dispara mensagens: confirmação de pedido, redefinição de senha, newsletter. Uma API de validação não envia nada: confere se o endereço existe e pode receber e-mails antes do envio. As duas se complementam: você valida primeiro e entrega ao serviço de envio só os endereços confiáveis.
Se você procura uma API para enviar e-mails, o VerificarEmails não é esse serviço. Mas, se você já usa um, validar os endereços antes reduz os bounces (rejeições) e protege a reputação do seu domínio remetente.
| API de envio (SMTP ou transacional) | API de validação de e-mail | |
|---|---|---|
| O que faz | Entrega mensagens aos destinatários | Confere se o endereço pode receber mensagens |
| Envia e-mail? | Sim | Não |
| Quando chamar | Na hora de mandar a mensagem | No cadastro, na importação ou antes de uma campanha |
| O que devolve | Confirmação de que a mensagem foi aceita e, depois, avisos de entrega ou de bounce | Um resultado por endereço: seguro, inválido, arriscado ou desconhecido |
Quando usar uma API para validar e-mail?
Use a API sempre que um endereço entra no seu sistema de forma automática, sem ninguém para conferir: no formulário de cadastro, na sincronização com o CRM e na importação de listas. Para conferir poucos endereços à mão, o campo web resolve; a API serve para validar no ponto de entrada, sem intervenção humana.
- Formulários em tempo real: a validação acontece no cadastro, no checkout ou no pedido de orçamento. Se a pessoa errou o domínio ao digitar, ela vê o aviso e corrige na hora, antes de enviar o formulário.
- CRM: valide cada contato novo ou editado antes de salvá-lo, para que vendas e marketing trabalhem com endereços que recebem mensagens.
- Importações e bases antigas: antes de carregar a planilha de um evento ou de reativar uma lista parada, valide tudo em massa e separe os contatos por resultado.
Se o seu formulário não permite programar no servidor, há caminhos sem código: o widget para formulários, os pop-ups com verificação, o n8n e o Zapier para verificar e-mails. Para conferir alguns endereços soltos sem cadastro, use o verificador de e-mail gratuito da página inicial.
Como a API verifica um e-mail sem enviar mensagem?
A API faz mais de 25 verificações por endereço. Começa pela sintaxe e pelo domínio, consulta os registros MX para saber qual servidor recebe as mensagens e conversa com esse servidor via SMTP para perguntar se a caixa existe, sem chegar a enviar nada. Também identifica spam traps, endereços descartáveis, contas de função e domínios catch-all.
A precisão do VerificarEmails é de 99,8 %, calculada sobre o histórico de verificações realizadas. Para entender cada etapa em detalhe, veja como funciona a verificação de e-mail.
O que a API de validação devolve?
Para cada endereço, a API devolve um resultado principal e marcas complementares. No VerificarEmails, os resultados são quatro: seguro, inválido, arriscado e desconhecido. As marcas dizem, por exemplo, se o endereço é descartável, uma conta de função ou de um domínio catch-all. Os nomes exatos dos campos da resposta estão na documentação.
| Resultado | O que significa | O que fazer |
|---|---|---|
| Seguro | O endereço passou nas verificações e pode receber e-mails. | Aceite e salve normalmente. |
| Inválido | A sintaxe está errada, o domínio não recebe e-mails ou a caixa não existe. | No formulário, peça para a pessoa corrigir. Na lista, remova. |
| Arriscado | O endereço pode existir, mas não dá para confirmar com segurança. É o caso dos domínios catch-all, que aceitam qualquer endereço. | Aceite com cautela: marque o contato, confirme com double opt-in e acompanhe os bounces. |
| Desconhecido | O servidor de e-mail não respondeu ou bloqueou a verificação. | Não bloqueie. Aceite e verifique de novo mais tarde. |
Marcas complementares
- Descartável: endereço de um serviço de e-mail temporário. Em cadastros com teste grátis, cupom ou material para download, vale pedir outro endereço.
- Conta de função: endereços genéricos, como contato@ ou vendas@. Servem para contatos B2B, mas costumam ser lidos por várias pessoas; avalie se fazem sentido numa campanha de marketing.
- Catch-all: o domínio aceita qualquer endereço, então não dá para confirmar a caixa específica. Por isso o resultado é arriscado.
- Caixa cheia: a caixa existe, mas não aceita mensagens no momento. Verifique de novo mais tarde antes de remover o contato.
- Desativado: a conta foi desativada. Tire o endereço da lista de envio.
Validação em tempo real ou em massa: qual usar?
Use a validação em tempo real quando os endereços chegam um por vez, como num formulário: a resposta leva de 1 a 2 segundos. Use a validação em massa para listas inteiras enviadas em arquivo, que levam de 30 a 120 minutos conforme o tamanho. O ideal é usar as duas: uma na entrada e outra na limpeza periódica.
| Tempo real | Em massa | |
|---|---|---|
| Quando usar | Formulários, checkout, CRM | Importações, listas antigas, antes de campanhas |
| Como funciona | Uma chamada à API por endereço | Envio de uma lista em arquivo (CSV ou Excel) pelo painel |
| Tempo | De 1 a 2 segundos por endereço | De 30 a 120 minutos, conforme o tamanho da lista |
| Uso do resultado | Decidir na hora se o cadastro segue | Separar a lista por resultado antes de enviar |
Como integrar a API para validar e-mail, passo a passo?
A integração tem cinco passos: criar a conta, pegar a chave de API, chamar a API a partir do seu servidor, definir o que fazer com cada resultado e testar antes de publicar. Em formulários, a chamada é individual e em tempo real; para listas inteiras, envie o arquivo (CSV ou Excel) pelo painel.
- Crie sua conta. O cadastro gratuito inclui 100 verificações de e-mail grátis, suficientes para testar a integração com endereços reais.
- Pegue a chave de API. Entre no painel, copie a sua chave e guarde-a numa variável de ambiente ou num cofre de segredos. Nunca a coloque no JavaScript que roda no navegador nem num repositório público.
- Chame a API a partir do seu servidor. Quando o formulário é enviado, ou quando o campo de e-mail perde o foco, o seu back-end chama a API com o endereço. A autenticação, os endpoints e os parâmetros estão na documentação em português.
- Defina o que fazer com cada resultado. Siga a tabela acima: só «inválido» bloqueia o envio; «arriscado» e «desconhecido» passam com uma marca. Salve o resultado junto com o contato.
- Teste e acompanhe. Antes de publicar, teste um endereço seu, um inválido de propósito e, se tiver, um de domínio catch-all. Depois, acompanhe os erros, o tempo de resposta e quantos cadastros caem em cada resultado.
Se a ideia é desenvolver a validação por conta própria, sem uma API externa, veja o que envolve criar o seu próprio verificador de e-mail. Para conhecer todos os recursos e modos de uso, acesse a página da API de validação de e-mail.
Quais são as boas práticas ao usar a API?
As regras básicas são quatro: definir um timeout curto, nunca bloquear o cadastro quando a API não responde, tratar «arriscado» e «desconhecido» de forma diferente de «inválido» e proteger a chave de API. Assim a validação filtra os endereços ruins sem deixar o formulário lento e sem afastar clientes reais.
- Timeout e plano B: a resposta costuma chegar em 1 a 2 segundos. Configure um limite de poucos segundos; se ele estourar, aceite o endereço, marque-o como pendente e valide de novo depois.
- Não bloqueie sem motivo: só «inválido» justifica impedir o envio do formulário. Mostre uma mensagem clara, como «Confira o endereço de e-mail», em vez de um erro genérico.
- «Arriscado»: aceite, mas marque o contato. Confirme o endereço com double opt-in e acompanhe os bounces dos primeiros envios.
- «Desconhecido»: é falta de resposta do servidor, não prova de que o endereço é ruim. Aceite e verifique de novo antes de incluir o contato numa campanha.
- Uma chamada por endereço: não chame a API a cada tecla digitada. Valide no envio do formulário ou quando o campo perde o foco, e reaproveite o resultado de endereços verificados há pouco tempo.
- Proteja o formulário contra robôs: sem captcha ou limite de tentativas, um robô pode gastar as suas verificações com endereços falsos.
- Dados pessoais: o e-mail é um dado pessoal. Informe a finalidade no cadastro e, ao contratar um fornecedor, verifique como ele trata os dados conforme a LGPD. No VerificarEmails, os dados ficam em servidores na União Europeia, com comunicações cifradas e cumprimento do RGPD.
Como escolher uma API para validar e-mail?
Compare as APIs pelo que elas verificam, pela velocidade e pelo tratamento dos casos duvidosos, não só pelo preço. Uma boa API confere a caixa via SMTP, identifica catch-all, descartáveis e contas de função, responde em poucos segundos, documenta bem a resposta e explica onde os dados ficam guardados.
- Verificações: a API vai além da sintaxe e do MX e confere a caixa no servidor SMTP?
- Casos duvidosos: ela separa «arriscado» e «desconhecido» de «inválido», ou joga tudo no mesmo saco?
- Tempo de resposta: é compatível com um formulário, ou seja, poucos segundos por endereço?
- Documentação: endpoints, erros e limites de uso estão bem explicados?
- Teste grátis: dá para testar com endereços reais antes de pagar?
- Dados: onde os endereços ficam e por quanto tempo?
Para uma comparação lado a lado, veja o comparativo de ferramentas de verificação de e-mail.
Perguntas frequentes
Qual é o formato de um endereço de e-mail válido?
Um endereço válido tem um nome de usuário, o sinal @ e um domínio, como usuario@dominio.com. Formas como «usuario.com», «usuario#dominio.com» ou «usuario.dominio» são inválidas. O formato correto, porém, não prova que a caixa existe: para isso, a API consulta o domínio, os registros MX e o servidor SMTP.
A API de validação envia algum e-mail ao destinatário?
Não. A API conversa com o servidor de e-mail do domínio para saber se a caixa aceita mensagens, mas não envia nada. O destinatário não recebe aviso nem mensagem de teste. Por isso a validação pode ser feita antes do primeiro contato, no momento do cadastro ou antes de importar uma lista.
Quanto tempo a API leva para validar um e-mail?
Em tempo real, de 1 a 2 segundos por endereço, o que permite usar a API em formulários sem deixar o cadastro lento. Listas enviadas em massa levam minutos, de 30 a 120 conforme o tamanho. Configure um timeout no seu código para que uma resposta lenta nunca trave o formulário.
Posso testar a API de validação de graça?
Sim. O cadastro gratuito no VerificarEmails inclui 100 verificações de e-mail grátis, que servem para testar a integração com endereços reais. Se você quer conferir só alguns endereços sem criar conta, o campo da página inicial permite verificar um número limitado deles, sem cadastro.
O que fazer quando a API devolve «desconhecido»?
Não bloqueie o endereço. «Desconhecido» significa que o servidor de e-mail não respondeu ou bloqueou a verificação, não que o endereço seja ruim. Aceite o cadastro, marque o contato e verifique de novo mais tarde, antes de incluí-lo numa campanha. Se o resultado se repetir, envie com cautela e acompanhe os bounces.