🎬 Apresentamos o transcript.im: transcrições gratuitas de vídeos do YouTube, TikTok e Instagram.Testar o transcript.im

API de Validação de Email

Um endpoint para cada tipo de verificação. Uma API de validação de e-mail em tempo real com verificações SMTP, respostas JSON estruturadas e integração nativa com MCP e Agent Skills.

Console do Email Validation API com requisição POST, cartão de API key, selo 200 OK e resposta em JSON
API de validação de email

Verifique em tempo real

Use uma chamada simples de API para verificar endereços durante o cadastro, enriquecimento, workflows de agentes IA ou pipelines personalizados de processamento de listas.

JSON estruturadoResposta em tempo realVerificação SMTP
Get Started for Free
API de validação de e-mail em tempo real retornando uma resposta 200 OK após uma verificação SMTP

Todos os modos da API de validação, um único endpoint

Cada tipo de verificação está disponível pela mesma REST API de validação de e-mail.

API de validação de e-mail grátis com cartões de modo Único, Lote, Arquivo e SDKs

Verificação de Email Único

POST /verify — uma chamada à API de validação de e-mail em tempo real com resposta em menos de 3s. Retorna status, entregabilidade, pontuação de qualidade e flags de risco em um único objeto JSON.

Verificação em Lote

POST /verify/bulk — valide até 50 endereços por chamada de API, de forma síncrona. Todos os resultados retornam em uma única resposta da API, com o mesmo esquema da validação individual.

Processamento Assíncrono de Arquivo

POST /verify/file — envie arquivos CSV ou Excel à API para processamento em segundo plano. Os resultados são entregues via webhook quando o job da API é concluído.

SDKs Oficiais

Bibliotecas cliente com tipagem segura para a API gratuita de validação de e-mail em Python, Node.js, Go e PHP. Nova tentativa automática em caso de falha, tratamento completo de erros e tipos de resposta idênticos em todas as linguagens.

Suporte a webhook na API de validação

Receba resultados da API de forma assíncrona e consulte o histórico de mensagens.

Webhook da API de validação de e-mail entregando um Evento de Callback com selo Tentar de novo

Entrega Assíncrona

Criar Webhooks

Registre endpoints HTTP para receber resultados da API assim que um job ou lote for concluído. A API aceita payloads personalizados, faz novas tentativas automáticas em caso de falha e permite configuração por job ou global.

  • Eventos de conclusão de job com resumo de resultados
  • Retry automático em falha de entrega
  • Configuração por job ou em nível de conta

Histórico de Mensagens

Consultar Mensagens

Acesse o log completo de eventos de webhook para recuperar resultados anteriores da API, depurar falhas de entrega ou reproduzir notificações perdidas. Os eventos da API são retidos por 30 dias.

  • Consultar eventos por ID de job ou intervalo de datas
  • Reenviar entregas perdidas ou com falha
  • Retenção de eventos por 30 dias

Contrato de resposta

O que a API de validação de e-mail retorna, campo por campo

A maioria das equipes adota uma API de validação para substituir uma expressão regular. A mudança só compensa se a resposta da API trouxer mais informações do que o valor booleano que substitui.

status é o campo que deve orientar as ramificações do seu código

A API retorna um de quatro status: deliverable, undeliverable, risky ou unknown. Há quatro estados porque a realidade tem quatro estados, e qualquer API de validação que os reduza a true e false obriga cada consumidor a recriar as nuances ausentes.

Comece a ramificação pelo status. Todo o restante da resposta da API gratuita de validação de e-mail explica esse status, em vez de substituí-lo.

score e nível de risco servem para ordenar, não para bloquear

Uma pontuação de qualidade de 0 a 100 e um nível de risco permitem ordenar uma fila, priorizar o acompanhamento de vendas ou ajustar um limite para cada contexto. Eles são campos derivados da API; portanto, trate-os como indicações de ordenação, não como o veredito da API.

Usar apenas a pontuação como critério de bloqueio faz equipes rejeitarem bons clientes por engano. Decida com base em status; ordene com score.

os códigos de motivo facilitam a depuração da API

Cada resposta não entregável da API traz um motivo legível por máquina. Sintaxe inválida, ausência de rota de e-mail, caixa rejeitada e adiamento pelo provedor são problemas diferentes, com soluções diferentes, e nossa API gratuita de validação de e-mail identifica cada um em vez de retornar uma falha genérica.

Registre o código de motivo da API, não o texto explicativo. Ele permanece estável entre versões e permite responder, meses depois, a um chamado de suporte sobre um endereço específico.

flags booleanas descrevem o endereço, não sua entregabilidade

E-mail descartável, conta de função, catch-all e webmail pessoal gratuito chegam como flags independentes da API. Um endereço pode ser perfeitamente entregável e ainda ter três delas, exatamente o caso que um validador de sintaxe não consegue expressar, mas uma API consegue.

Esta é a diferença prática entre uma API de validação de e-mail em tempo real e uma verificação de formato: a verificação de formato informa se a string está bem formada, enquanto a API informa o que o endereço realmente é.

Migração

De um validador de sintaxe para uma API de validação completa

As equipes geralmente chegam aqui com uma regex ou uma chamada de biblioteca já presente no código. A migração para a API é pequena, mas exige mudar três hábitos.

Pare de tratar o formato como resposta

Uma expressão regular prova que uma string pode ser um endereço. Esta API gratuita de validação de e-mail prova que um servidor de e-mail o aceita neste momento. Se quiser, mantenha a regex como uma indicação barata no lado do cliente, mas deixe de usá-la para decidir se um registro é válido.

Na prática, isso significa remover a ramificação que diz que um formato válido deve ser salvo e substituí-la por uma ramificação baseada no campo status da API.

Defina timeout e fallback para a API

Uma chamada de rede pode ficar lenta quando o provedor receptor está lento. Defina para a API um timeout compatível com seu formulário e decida antecipadamente o que ocorrerá ao expirar: em geral, aceite o endereço, marque-o como não verificado e verifique-o novamente com outra chamada posterior à API.

Uma API de validação de e-mail em tempo real nunca deve causar a falha de um cadastro. Use o estado não verificado como fallback, em vez de rejeitar.

Armazene o resultado como dado, não como filtro

Grave no registro o status da API, o código de motivo, as flags e um timestamp da verificação. Uma equipe que armazena apenas um booleano final não consegue explicar a decisão de suprimir um contato três campanhas depois, nem distinguir evidências recentes da API de evidências antigas.

Armazenar a resposta completa da API também permite mudar a política sem verificar novamente: os fatos permanecem, e muda apenas a regra que os interpreta.

Trate unknown deliberadamente, uma única vez

Unknown não é um erro da API nem uma falha. Significa que o provedor receptor não deu uma resposta definitiva. Defina a política de novas tentativas em um único lugar — uma fila, um atraso e um número máximo de tentativas na API — em vez de espalhar tentativas ad hoc pelo código.

A maioria dos resultados unknown é resolvida em uma chamada posterior à API; por isso, nossa API gratuita de validação de e-mail os informa com honestidade em vez de adivinhar.

Formas de integração

Quatro formas de chamar a API de validação de e-mail

Um endpoint, quatro formatos de API. Escolha conforme o volume e a latência do trabalho, não por preferência.

  1. 1

    Um endereço, de forma síncrona

    POST /verify recebe um endereço e retorna o JSON completo em um a três segundos. Este é o caminho da API de validação de e-mail em tempo real usado por formulários de cadastro, checkout e edições de perfil.

    Como é uma única chamada de API, sem ciclo de vida de job, também é a interface mais fácil de testar antes de você criar algo maior.

  2. 2

    Até 50 endereços em uma chamada

    POST /verify/bulk verifica até 50 endereços de forma síncrona e os retorna com o mesmo esquema. Use quando uma página ou um job processar naturalmente alguns registros por vez.

    O limite do lote é uma fronteira rígida da API, não uma orientação flexível. Payloads maiores são rejeitados com um erro claro da API que indica o endpoint de arquivo; assim, nada se transforma silenciosamente em uma solicitação lenta.

  3. 3

    Arquivos, de forma assíncrona

    POST /verify/file aceita CSV ou Excel, processa em segundo plano e chama seu webhook quando o job da API termina. Nenhuma conexão precisa permanecer aberta durante o processamento de um arquivo grande.

    Para uma carga de trabalho baseada em listas, e não em chamadas de API, Verificação de e-mail em massa executa o mesmo mecanismo em um arquivo enviado, com desduplicação e exportação em CSV.

  4. 4

    Por agentes de IA e clientes MCP

    O MCP Server expõe a mesma API de validação de e-mail ao Claude Desktop e Cursor em linguagem natural, e as Agent Skills a instalam em plataformas de agentes com um clique. Ambos retornam o mesmo JSON estruturado da REST API.

    Isso mantém o comportamento do agente fiel aos fatos: a ferramenta não pode resumir unknown como algo aceitável, porque a resposta da API gratuita de validação de e-mail é exatamente o que o agente lê.

Escopo

O que a API de validação deixa deliberadamente para você

A API é restrita de propósito. Cada item abaixo é um requisito real — ele apenas pertence a outra parte do seu sistema, não a uma API de validação.

Consentimento e supressão

Nossa API gratuita de validação de e-mail informa se um endereço aceita mensagens. Ela não informa se a pessoa concordou em recebê-las e não consulta sua lista de supressão.

Mantenha o consentimento no seu próprio sistema de registro e confira-o antes, não depois, da chamada à API.

Identidade e vínculo empregatício

Um endereço corporativo entregável não prova que a pessoa indicada o controla ou ainda trabalha na empresa. Aliases, caixas de entrada compartilhadas e dados de enriquecimento desatualizados quebram essa suposição com frequência.

Use dados próprios para confirmar a identidade. Esta API gratuita de validação de e-mail retorna evidências sobre uma caixa de entrada, não sobre uma pessoa.

Colocação na caixa de entrada

A aceitação SMTP é um fato do lado do destinatário. A chegada da mensagem à caixa de entrada depende da reputação do remetente, da autenticação, do conteúdo e do histórico de reclamações, fatores que a API não consegue observar.

Corrija a qualidade dos endereços com a API; corrija a colocação com ações do lado do remetente e monitoramento que a API não pode fazer por você.

Atualidade

Cada resposta da API descreve o momento da chamada. Caixas são encerradas, aliases desativados e domínios migrados; portanto, um resultado armazenado da API perde atualidade, mesmo que ninguém volte a consultá-lo.

Verifique novamente em uma frequência adequada à velocidade de mudança dos seus dados e deixe o timestamp da verificação orientar essa decisão automaticamente.

Recursos relacionados

Como a API de validação de e-mail se encaixa entre as outras ferramentas

O mesmo mecanismo está por trás de várias interfaces de API. A escolha depende de quem faz a solicitação e de quantos endereços estão envolvidos.

A perspectiva de verificação do mesmo endpoint

A API de verificação de e-mail documenta o mesmo endpoint para equipes que pesquisam por verificação, e não por validação, explicando as evidências SMTP com mais profundidade.

O esquema, os créditos e a precisão são idênticos — muda apenas a perspectiva da documentação.

Uma ferramenta no navegador para um endereço

Quando alguém precisa consultar um único resultado em vez de automatizar algo, o Verificador de e-mail executa o mesmo pipeline no navegador e mostra todas as flags que a API retornaria.

É a forma mais rápida de confirmar o comportamento do mecanismo antes de escrever código para a API gratuita de validação de e-mail.

Validação superficial sem SMTP

Se o requisito for realmente apenas formato e roteamento de e-mail, o Validador de e-mail limita-se à sintaxe e ao MX, sem nunca consumir uma verificação SMTP.

Use-o como uma pré-verificação econômica e reserve a API de validação de e-mail em tempo real para os registros em que uma rejeição realmente teria um custo.

Perguntas Frequentes

1. Qual é a velocidade da API de validação de e-mail?

Resultados da API em cache retornam em menos de 200ms. A validação SMTP completa leva de 1–3 segundos em média, o que permite usar esta API de validação de e-mail em tempo real dentro de um formulário. A API aceita até 6,000 solicitações individuais por minuto e 1,500 solicitações em lote por minuto.

2. Como integro a API de validação de e-mail?

A API de validação usa chamadas REST padrão com respostas JSON. Há SDKs oficiais para Python, Node.js, Go e PHP. A maioria das integrações de API leva menos de 30 minutos. O MCP Server e as Agent Skills não exigem código — instale uma vez e a API gratuita de validação de e-mail funcionará em qualquer cliente de IA compatível.

3. Quanto custa a API de validação de e-mail?

O plano Starter custa $20 por 20,000 créditos, a $0.001 por e-mail — sem mensalidade; você paga apenas pelo que usar. O preço por volume cai para $0.00035 por e-mail na compra de 1M de créditos. O nível gratuito da API de validação de e-mail oferece 20 créditos grátis a cada dia em que você fizer login, até 600 por mês, sem exigir cartão de crédito.

4. O que cada resposta da API de validação inclui?

Cada resposta da API inclui o status de validação (deliverable, undeliverable, risky ou unknown), uma pontuação de qualidade de 0–100, um nível de risco e códigos de motivo. Também inclui flag de e-mail descartável, flag de conta de função, detecção de catch-all e sugestões para corrigir erros de digitação.

5. A API de validação é segura?

Todas as solicitações da API usam HTTPS. A autenticação por chave de API é obrigatória em cada chamada, e a lista de permissões de IP oferece segurança adicional. O BillionVerify está em plena conformidade com GDPR e CCPA e exclui os dados automaticamente após o processamento.

6. Como agentes de IA e LLMs usam esta API de validação?

Agentes de IA se conectam pelo MCP Server (linguagem natural no Claude e Cursor), por Agent Skills prontas (instalação com um clique para Claude e Manus) ou por chamadas REST diretas do LangChain, CrewAI ou de qualquer SDK da Anthropic ou OpenAI. Todos os caminhos acessam a mesma API de validação de e-mail e retornam o mesmo JSON estruturado — sem precisar transformar a resposta.

7. Qual é a diferença entre uma API de validação de e-mail e uma API de verificação de e-mail?

Uma API de validação de e-mail e uma API de verificação de e-mail geralmente se referem ao mesmo tipo de endpoint — aquele que verifica se um endereço é real e entregável. O BillionVerify executa verificações no nível SMTP, confirmando que a caixa existe no servidor receptor, em vez de validar apenas DNS ou sintaxe. O endpoint único /verify retorna status, pontuação de qualidade, flag de descartável, flag de conta de função e detecção de catch-all em uma única resposta JSON.

API de Validação de Email

Obtenha sua chave de API

Um endpoint para cada tipo de validação. MCP Server e Agent Skills incluídos. O nível gratuito da API de validação de e-mail oferece 20 créditos a cada dia em que você fizer login, até 600 por mês, sem exigir cartão de crédito.

600 créditos grátis por mês · Integração nativa com MCP Server · Sem cartão de crédito necessário

99.9%
Precisão
Real-time
Velocidade da API
$0.00014
Por e-mail
600/mo
Grátis para sempre