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

API de verificação de e-mail

API de verificação de e-mail em tempo real via HTTP com verificações SMTP completas da caixa — a API precisa para entregabilidade, não só para o formato.

Console do Email Verification API com requisição Bearer, selo 200 OK e gráfico de disponibilidade
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 verificação de e-mail em tempo real retornando uma resposta 200 OK após uma sonda SMTP

Todos os modos da API de verificação, um endpoint

Cada tipo de verificação está disponível através da mesma API REST de verificação de e-mail.

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

Verificação de um único e-mail

POST /verify — uma chamada à API de verificação de e-mail em tempo real com resposta em menos de 3s. Devolve estado, entregabilidade, quality score e flags de risco num único objeto JSON.

Verificação em lote

POST /verify/bulk — verifique até 50 endereços por chamada à API, de forma síncrona. Todos os resultados chegam numa única resposta da API, com o mesmo schema que a API de verificação de e-mail em tempo real usa para um endereço.

Processamento assíncrono de ficheiros

POST /verify/file — envie ficheiros CSV ou Excel para a API processar em segundo plano. Os resultados são entregues por callback de webhook quando o job da API termina.

SDKs oficiais

Bibliotecas cliente type-safe para a API de verificação em Python, Node.js, Go e PHP. Retry automático em caso de falha, tratamento completo de erros e tipos de resposta idênticos em todas as linguagens.

Suporte a webhooks na API de verificação

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

Webhook da API de verificação de e-mail entregando um Evento de Callback assinado com Assinatura

Entrega assíncrona

Criar webhooks

Registe endpoints HTTP para receber resultados da API assim que um job ou lote termina. A API suporta payloads personalizados, retry automático em caso de falha e configuração por job ou global.

  • Eventos de conclusão de job com resumo de resultados
  • Retry automático em entregas falhadas
  • Configuração por job ou ao nível da conta

Histórico de mensagens

Consultar mensagens

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

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

Dentro do endpoint

O que a API de verificação de e-mail comprova em cada chamada

Uma API de verificação de e-mail só é útil quando cada campo da resposta se apoia em evidências. Esta devolve factos ao nível da caixa, não uma opinião sobre a sintaxe disfarçada de veredito.

Sintaxe e encaminhamento são as camadas baratas, não a resposta

Cada chamada à API de verificação de e-mail normaliza o endereço, verifica a estrutura e resolve os registos MX do domínio. Estas duas camadas da API são rápidas e não interagem com o destinatário, por isso são executadas primeiro e eliminam lixo óbvio antes da etapa SMTP.

Uma API limitada à sintaxe para aqui e declara o resultado válido. É essa a diferença entre um endpoint de validação e uma API gratuita de verificação de e-mail que avança até à própria caixa.

É no SMTP que a API de verificação faz jus ao nome

A API abre uma conversa SMTP real com o servidor recetor e testa o caminho do destinatário. Não envia o corpo de uma mensagem, não clica em qualquer link de confirmação e nada chega à caixa de entrada da pessoa. A nossa API gratuita de verificação de e-mail lê a resposta do servidor até conseguir distinguir um destinatário aceite de uma rejeição permanente.

É isto que a torna uma API de verificação de e-mail em tempo real, e não uma consulta DNS acompanhada de texto de marketing. A evidência vem do sistema que irá realmente aceitar ou recusar o seu e-mail.

As flags de risco acompanham o estado na mesma resposta

Um único objeto JSON da API contém o estado de entregabilidade, um quality score, um nível de risco, códigos de motivo e as flags de e-mail descartável, conta de role, catch-all e webmail gratuito. A sua aplicação não precisa de uma segunda chamada à API para perceber por que razão um resultado tem esse aspeto.

Manter as flags junto do estado é deliberado. Um endereço de role aceite e uma caixa pessoal aceite são ambos entregáveis, e só o seu produto sabe qual deles pertence a este workflow.

As respostas inconclusivas continuam inconclusivas

Greylisting, adiamentos do provedor e limites de pedidos são normais à escala de uma API. Nesses casos, a API gratuita de verificação de e-mail devolve unknown em vez de os promover a deliverable ou rebaixar a invalid.

A lógica de retry pertence ao seu código, não deve ficar escondida no endpoint. Uma API que adivinha em silêncio elimina precisamente o sinal de que precisa para decidir se tenta novamente ou encaminha o registo para revisão.

Campos da resposta

Associe cada estado da API de verificação a uma decisão da aplicação

A resposta da API foi concebida para ser usada diretamente num switch. Cada estado corresponde a uma ação, e os códigos de motivo da API explicam os casos no limite.

deliverable — continuar

O caminho do destinatário aceitou a sonda quando a chamada foi executada. Aceite o registo, grave o contacto ou coloque a mensagem em fila, sujeito às regras de consentimento aplicadas pelo seu produto.

A API gratuita de verificação de e-mail devolve o mesmo campo de estado no nível gratuito e no volume pago, por isso o comportamento que testa com créditos grátis é o comportamento que lança.

undeliverable — rejeitar ou pedir novamente

Uma falha permanente da API significa que o endereço fará hard bounce. Num formulário de registo, volte a mostrar o campo com o código de motivo da API. Num job em segundo plano, suprima o registo em vez de eliminar o valor original.

Nunca corrija automaticamente o domínio. Uma API de verificação pode dizer que um endereço falha; não pode dizer que endereço a pessoa pretendia escrever.

risky — aplicar a sua própria política

Risky significa que a caixa pode aceitar e-mail, mas tem uma flag que pode ser relevante para o seu produto. Leia os códigos de motivo: um provedor descartável num registo pago é um problema muito diferente de um endereço de role num formulário de suporte.

Codifique a política uma vez, no ponto onde chama a nossa API gratuita de verificação de e-mail, para que todas as superfícies do produto tratem a mesma flag da API da mesma forma.

unknown — tentar novamente, não descartar

O provedor recetor deu à API uma resposta que nada comprova. Coloque o endereço em fila para uma chamada posterior à API, em vez de bloquear o utilizador ou gravar um falso negativo na sua base de dados.

A API de verificação de e-mail em tempo real usada num fluxo de registo deve degradar graciosamente neste caso: deixe o utilizador avançar, verifique novamente de forma assíncrona e aja com base no segundo resultado da API.

Padrões de integração

Onde chamar a API de verificação de e-mail num sistema real

A maioria das integrações da API usa os mesmos três pontos de contacto. Posicionar corretamente a chamada à API é mais importante do que o SDK escolhido.

  1. 1

    No ponto de recolha

    Chame a API quando um endereço é enviado — num registo, checkout, formulário de lead ou atualização de perfil. Verificar enquanto a pessoa ainda está na página é a única altura em que o erro de escrita pode ser corrigido por quem o cometeu, o melhor argumento para uma chamada inline à API.

    Não deixe que a chamada bloqueie o fluxo para além de um timeout curto. Uma resposta da API gratuita de verificação de e-mail chega normalmente em um a três segundos, mas o formulário não deve falhar porque um provedor recetor foi lento.

  2. 2

    Dentro do pipeline que já movimenta os seus dados

    Jobs de sincronização com o CRM, workers de enriquecimento e etapas ETL são locais naturais para esta API gratuita de verificação de e-mail. Adicione a chamada à API onde os registos já circulam e guarde o estado, as flags e um timestamp da verificação como campos.

    Para ficheiros em vez de registos individuais, a API POST /verify/file aceita CSV ou Excel e chama o seu webhook quando o job termina, pelo que o trabalho da API em lote não precisa de uma ligação persistente.

  3. 3

    Dentro de agentes e ferramentas de IA

    O MCP Server disponibiliza a nossa API gratuita de verificação de e-mail ao Claude Desktop e ao Cursor em linguagem natural, e as Agent Skills instalam-na em plataformas de agentes com um clique. Ambos os métodos devolvem o mesmo JSON estruturado que a API REST.

    Isto é importante para a fiabilidade dos agentes: um modelo não precisa de fazer parse de texto corrido, e a ferramenta não pode afirmar que um endereço está correto quando a API subjacente devolveu unknown.

  4. 4

    Em torno do próprio envio

    A atualidade supera o volume. Verifique os destinatários de alto valor perto do envio em vez de confiar num estado gravado há meses, e volte a verificar registos inativos antes de entrarem numa campanha.

    Para uma lista inteira, Verificação de Email em Massa executa o mesmo motor num ficheiro, para que não tenha de reconstruir lógica de lotes sobre o endpoint em tempo real.

Limites honestos

Quatro coisas que a API de verificação de e-mail não afirma

A resposta da API é fiável porque o seu âmbito é restrito. Cada um destes pontos pertence a uma ferramenta ou equipa diferente, não a uma API de verificação.

Não comprova identidade nem consentimento

Uma caixa que aceita e-mail nada diz sobre quem a controla, onde essa pessoa trabalha ou se aceitou ser contactada. Aliases partilhados, endereços reencaminhados e dados de enriquecimento desatualizados geram resultados deliverable da API associados à pessoa errada.

Use dados próprios para confirmar a identidade e mantenha o consentimento no seu sistema de registo. Nenhuma API de verificação pode fornecer qualquer um deles.

Não garante a colocação na caixa de entrada

A aceitação SMTP descreve o caminho do destinatário no momento da chamada à API. A chegada da campanha à caixa de entrada depende da reputação do remetente, autenticação, conteúdo e histórico de queixas — todos fatores do lado do remetente que a API nunca observa.

A verificação remove falhas ao nível do endereço. A entregabilidade da própria mensagem é um programa separado, com métricas próprias.

Os domínios catch-all continuam incertos

Um domínio catch-all aceita qualquer parte local, pelo que nenhuma API gratuita de verificação de e-mail consegue provar que um endereço imaginado existe nesse domínio. A API devolve a flag precisamente para que o seu código não tenha de a inferir.

Encaminhe os resultados catch-all para revisão em vez de os incluir em deliverable, sobretudo em listas B2B construídas a partir de padrões de nomes.

Um resultado é uma observação com timestamp

Todos os dias, caixas são encerradas, aliases desativados e domínios migrados. A API comunica o que era verdade durante a chamada, e esse facto envelhece a partir do segundo em que a API responde.

Guarde a hora da verificação junto do estado, para que os sistemas seguintes possam decidir quando as evidências são demasiado antigas para servir de base a uma ação.

Superfícies relacionadas

Como a API de verificação se relaciona com o resto da plataforma

O mesmo motor está disponível através de várias superfícies da API. A escolha certa depende normalmente de quem faz o pedido, não da precisão.

Um endereço, manualmente

Quando alguém precisa de analisar um resultado em vez de automatizar milhares, o Verificador de E-mail executa no browser o mesmo pipeline SMTP e mostra todas as flags que a API devolveria.

É a forma mais rápida de testar um endereço antes de escrever código para a API de verificação de e-mail.

Um ficheiro inteiro de uma só vez

Quando o trabalho é uma lista e não um fluxo, a Limpeza de Listas de E-mail aplica as mesmas regras a todas as linhas e preserva os motivos na exportação.

Os ficheiros e as chamadas à API partilham um único motor, por isso uma linha limpa em massa e um endereço verificado através da API de verificação não podem apresentar resultados diferentes.

O enquadramento centrado na validação

A API de Validação de Email descreve o mesmo endpoint para as equipas que pesquisam validação em vez de verificação, com os detalhes de integração escritos a partir desse ângulo.

O endpoint, o schema e as evidências SMTP são idênticos; apenas muda o enquadramento da documentação.

Perguntas frequentes

1. Quão rápida é a API de verificação de e-mail?

Os resultados da API em cache regressam em menos de 200ms. A verificação SMTP completa demora, em média, 1–3 segundos, o que permite usar esta API de verificação de e-mail em tempo real num formulário. A API suporta até 6,000 pedidos individuais de verificação por minuto e 1,500 pedidos em lote por minuto.

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

A API de verificação usa chamadas REST standard com respostas JSON. Estão disponíveis SDKs oficiais para Python, Node.js, Go e PHP. A maioria das integrações da API fica concluída em menos de 30 minutos. O MCP Server e as Agent Skills não exigem código — instale uma vez e a API de verificação de e-mail em tempo real funciona em qualquer cliente de IA suportado.

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

O plano Starter custa $20 por 20,000 créditos, a $0.001 por e-mail — sem mensalidades, paga apenas o que usar. O preço por volume desce até $0.00035 por e-mail com 1M de créditos. Um nível gratuito da API de verificação de e-mail oferece 20 créditos grátis por cada dia em que iniciar sessão, até 600 por mês, sem cartão de crédito.

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

Cada resposta da API inclui o estado de verificação (deliverable, undeliverable, risky ou unknown), um quality score de 0–100, um nível de risco e códigos de motivo. Inclui também flags de e-mail descartável e de conta de role, deteção catch-all e sugestões de correção de erros de escrita.

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

Todos os pedidos da API usam HTTPS. Cada chamada exige autenticação por API key, e está disponível uma whitelist de IP para segurança adicional. A BillionVerify cumpre plenamente o GDPR e a CCPA, com eliminação automática dos dados após o processamento.

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

Os agentes de IA ligam-se através do MCP Server (linguagem natural no Claude e Cursor), de Agent Skills pré-construídas (instalação de um clique para Claude e Manus) ou de chamadas REST diretas a partir de LangChain, CrewAI ou qualquer SDK Anthropic ou OpenAI. Todos os métodos acedem à mesma API de verificação de e-mail e devolvem o mesmo JSON estruturado — sem transformar a resposta.

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

Uma API de validação de e-mail e uma API de verificação de e-mail referem-se normalmente ao mesmo endpoint — um endpoint que verifica se um endereço é real e entregável. A BillionVerify usa verificação ao nível SMTP, confirmando que a caixa existe no servidor recetor, em vez de se limitar à validação DNS ou de sintaxe. O endpoint único /verify devolve estado, quality score, flag de descartável, flag de conta de role e deteção catch-all numa única resposta JSON.

API de Verificação de E-mail

Obtenha a sua API key

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

600 créditos grátis por mês · Integração nativa do servidor MCP · Sem cartão de crédito

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