logo
logo
Início / validador de correio eletrônico / API para validar e-mail: guia passo a passo de integração

API para validar e-mail: guia passo a passo de integração

api validar direcciones de correo electrónico

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

- MELHORE A QUALIDADE DE SEUS DADOS DE MANEIRA SIMPLES - VOCÊ PODE USAR O SOFTWARE PARA MELHORAR A QUALIDADE DE SEUS DADOS.
VERIFICA E-MAILS
TELEFONES
ENDEREÇOS POSTAIS
NOMES E NOMES...