API V2
A versão 2 da API Captain Verify já está disponível e inclui novos recursos. Se você está procurando uma maneira confiável de verificar a validade de seus e-mails, pode integrar a API de verificação de e-mail do Captain Verify em seus próprios aplicativos.
Chave API
É necessária uma conta para gerar a chave da API, é isso que lhe dará acesso ao serviço.
limites de API
A API está limitada a um máximo de 2 conexões simultâneas e 50 verificações por minuto. Ao integrar a API, certifique-se de que seu aplicativo não exceda esse limite.
O pedido
Para fazer uma solicitação à API, basta chamar o protocolo GET nesta URL:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Substitua john.doe@gmail.com pelo seu e-mail para verificar.
A resposta
Uma tabela json será retornada com estas variáveis:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok4all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
| Variáveis | valor possível |
|---|---|
| credits | Créditos disponíveis em sua conta. |
| result | valid, invalid, risky, unknown O status do e-mail. caso todos os seus créditos tenham sido esgotados, o status desconhecido sempre será retornado, para não bloquear sua inscrição. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Entenda o resultado de uma auditoria. |
| free | true, false Se o provedor de e-mail for gratuito, por exemplo, Gmail.com. |
| role | true, false Se o usuário do e-mail tiver uma função, ex: suporte@exemplo.com. |
| disposable | true, false O e-mail é válido, mas descartável após pouco tempo não será mais possível entrar em contato com o usuário. |
| ok4all | true, false Ok para todos: o servidor de correio remoto aceita todos os e-mails (pega-tudo). |
| protected | true, false O e-mail é protegido por uma solução antispam proprietária |
| mailboxfull | true, false O endereço de e-mail está cheio. Ela não pode mais receber correspondência |
| did_you_mean | default : null Se, por exemplo, o e-mail for john.doe@gmil.com, a API enviará uma proposta como john.doe@gmail.com. |
| O e-mail que você deseja verificar. | |
| email_normalized | O e-mail foi normalizado, removendo tags para gmail... suporte+teste@gmail.com será suporte@gmail.com. |
| success | true, false Se a autenticação falhar, seus créditos serão esgotados. |
| message | default : null Quando o sucesso for falso, uma mensagem de erro será enviada. |
Por que integrar uma API de verificação de email?
Uma base de contatos se degrada rápido. Endereços digitados com erro de digitação, emails descartáveis criados para passar por um formulário, caixas abandonadas e depois encerradas: cada endereço inválido que entra no seu sistema acaba em hard bounce. E os bounces custam caro. Eles inflam suas faturas de envio, distorcem suas estatísticas de campanha e, principalmente, prejudicam sua reputação do remetente junto aos provedores de email.
A limpeza manual sempre chega tarde demais. Uma vez que o endereço é registrado no seu CRM, ele já poluiu seus segmentos, seus scores de lead e suas exportações. A verificação programática inverte a lógica: o endereço é verificado no momento exato da coleta, antes de ser armazenado.
É exatamente esse o papel de uma API de verificação de email. Você envia um endereço, recebe um veredito que seu código pode processar e decide o que fazer com ele: aceitar, rejeitar ou pedir uma correção ao usuário. Tudo isso sem intervenção humana.
Casos de uso da API
Validação em tempo real no cadastro
Conecte a API aos seus formulários de cadastro, de download ou de orçamento. Os erros de digitação (gmail que virou gmial), os emails descartáveis e os endereços inexistentes são detectados antes do registro. O usuário pode corrigir imediatamente o que digitou, e apenas endereços válidos entram na sua base.
Limpeza em massa antes de uma campanha
Uma lista parada por alguns meses acumula endereços mortos. Antes de um envio importante, passe a lista pela API para descartar os endereços inválidos ou arriscados. Resultado: uma taxa de bounce sob controle, estatísticas de campanha confiáveis e um orçamento de envio concentrado em destinatários que existem de verdade.
Confiabilidade do CRM
Conecte a verificação aos seus pontos de entrada de dados: importações, integrações, cadastros feitos pela equipe comercial. Cada contato é qualificado desde a criação, com um status claro sobre a validade do seu email. Suas equipes trabalham com fichas limpas e seu scoring de leads se apoia em dados reais.
Proteção da reputação do remetente
Os provedores de email monitoram seus hard bounces e seus envios para spam traps. Incidentes demais, e seus emails legítimos acabam no spam. Ao filtrar os endereços perigosos antes de cada envio, a API protege sua reputação do remetente e, portanto, a entregabilidade de todas as suas comunicações.
Perguntas frequentes sobre a API
O que exatamente a API verifica?
Vários controles são executados em sequência: sintaxe do endereço, existência do domínio e dos seus registros MX, e depois um teste SMTP para verificar se a caixa aceita mensagens. A API também detecta os emails descartáveis e os endereços de função (contact@, info@). A resposta é retornada no formato JSON.
A API funciona em tempo real?
Sim. Cada requisição dispara uma verificação imediata e retorna o resultado na hora, o que permite integrá-la diretamente em um formulário ou em um fluxo de cadastro. Para grandes volumes, a verificação de arquivos completos continua disponível na sua conta.
Quanto custa?
A cobrança funciona por créditos: uma verificação consome um crédito, sem assinatura obrigatória. Os créditos comprados servem tanto para a API quanto para a verificação de arquivos. Os detalhes dos volumes e dos preços decrescentes estão disponíveis na página de nossos preços.