O que é a API de verificação de email?

A API de verificação de email permite que você valide endereços de email em tempo real através de uma solicitação GET. Ela verifica sintaxe, registros MX, listas negras e realiza verificação SMTP.

Como faço para autenticar usando a API?

Você deve fornecer uma chave API válida gerada no painel da EmailVerify.io. Solicitações sem uma chave ou com uma chave inválida falharão.

Quais verificações são realizadas durante a validação de email?

As verificações incluem validação por regex, pesquisa de registro MX, verificação de lista negra MX e verificação de caixa postal em nível SMTP.

Quais mensagens de erro a API pode retornar?

Erros comuns incluem Chave API Inválida, Solicitação Inválida, 0 créditos restantes e Por favor tente novamente quando o servidor encontra um problema.

Posso verificar meus créditos restantes via API?

Sim. O endpoint /check-account-balance/ permite que você verifique o status da API, limites diários, créditos de indicação e créditos restantes.

Documentação da API

Instruções de Verificação Instantânea

Introdução

Bem-vindo à API de Validação de E-mail Único da EmailVerify.io! Esta API permite validar um único endereço de e-mail em tempo real com a ajuda de uma solicitação simples, garantindo precisão e confiabilidade em suas comunicações por e-mail.

Autenticação

Para acessar a API, você precisa de uma chave de API válida. Você pode gerar sua chave pessoal na seção de API após fazer login na sua conta. Esta chave é necessária para autenticação e para fazer solicitações com segurança.

Endpoint da API

Valide um único endereço de e-mail substituindo os espaços reservados pela sua chave de API exclusiva e o e-mail a ser validado na seguinte URL:

URL de Requisição GET (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

Exemplo de Resposta Bem-Sucedida

Você receberá uma resposta como esta se sua solicitação de e-mail único for processada com sucesso:

URL

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

Verificações Realizadas na Validação de E-mail Único

Validação com Regex: Verifica a estrutura dos endereços de e-mail com base em padrões regex do setor para identificar erros de digitação e formatação antes do processamento.

Validação MX: Verifica registros válidos de troca de e-mails (MX) para confirmar que o domínio está configurado para receber mensagens, garantindo que ele exista e esteja ativo.

Validação de Lista Negra MX: Identifica domínios listados em listas negras conhecidas por spam ou atividades maliciosas, ajudando você a evitar destinos de e-mail não confiáveis ou perigosos.

Validação SMTP: Realize verificação em tempo real pingando o servidor SMTP do destinatário para confirmar se o endereço de e-mail está ativo e pode receber mensagens.

Respostas de Erro

Mensagem de Erro

Descrição

Chave de API Inválida

Se a chave estiver desativada ou não existir

Requisição Inválida

parâmetros inválidos no endpoint da API

0 créditos restantes

O usuário não possui créditos disponíveis

Por favor, tente novamente

Quando algo deu errado do nosso lado

Verificar Saldo da Conta

Use a seguinte requisição GET para verificar o saldo atual da conta (créditos diários e instantâneos restantes).

URL de Requisição GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aqui, substitua <Your_API_Key> pela sua chave de API ativa.

Resposta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instruções de Verificação em Massa

Introdução

Bem-vindo à API de Verificação de E-mails em Massa da EmailVerify.io! Esta API permite validar até 5000 endereços de e-mail em tempo real com uma solicitação simples, garantindo precisão e confiabilidade na sua comunicação por e-mail.

Este endpoint permite enviar lotes de até 5000 e-mails por vez. Se você deseja validar e-mails individualmente, por favor, use nosso endpoint de validação de e-mail único.

Autenticação

Para acessar a API, você precisará de uma chave de API válida. Gere sua chave pessoal na seção de API após fazer login na sua conta. Esta chave é necessária para autenticação e para fazer solicitações com segurança.

Endpoint da API

Para validar seus endereços de e-mail, substitua o espaço reservado pela sua chave de API exclusiva e inclua os e-mails no corpo da

URL de Requisição POST (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

Requisição POST

Você pode validar até 5000 endereços de e-mail enviando-os na seguinte requisição POST.

Requisição POST

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

Exemplo de Resposta Bem-Sucedida

Você receberá uma resposta como esta quando sua tarefa de verificação em massa for criada com sucesso.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

Requisição GET

Este endpoint recupera os resultados de uma tarefa de verificação em massa criada anteriormente. Os resultados incluirão o status geral da tarefa e, se concluída, os resultados da verificação.

URL de Requisição GET

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

Exemplo de Resposta Bem-Sucedida

Aqui está uma resposta de exemplo quando sua tarefa de verificação estiver completa:

Requisição POST

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

Verificações Realizadas na Validação de E-mails em Massa

Validação com Regex: Verifica a estrutura dos endereços de e-mail com base em padrões regex do setor para detectar erros de digitação e formatação antes do processamento.

Validação MX: Verifica registros válidos de troca de e-mails (MX) para confirmar que o domínio está configurado para receber mensagens, garantindo que ele exista e esteja ativo.

Validação de Lista Negra MX: Identifica domínios listados em listas negras conhecidas por spam ou atividades maliciosas, ajudando você a evitar destinos de e-mail não confiáveis ou perigosos.

Validação SMTP: Realize verificação em tempo real pingando o servidor SMTP do destinatário para confirmar se o endereço de e-mail está ativo e pode receber mensagens.

Respostas de Erro

Mensagem de Erro

Descrição

Chave de API Inválida

Se a chave de API estiver desativada ou não existir.

Requisição Inválida

Parâmetros inválidos no endpoint da API

0 créditos restantes

Se o usuário não tiver créditos disponíveis.

Por favor, tente novamente

Quando algo deu errado do nosso lado.

Verificar Saldo da Conta

Use a seguinte requisição GET para verificar o saldo atual da conta (créditos diários e instantâneos restantes).

URL de Requisição GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aqui, substitua <Your_API_Key> pela sua chave de API ativa.

Resposta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

Instruções do Localizador de E-mail Único

Introdução

A API de e-mail único permite encontrar um endereço de e-mail profissional em tempo real usando o nome de uma pessoa e o domínio da empresa. É projetada para resultados rápidos, precisos e confiáveis, ideal para geração de leads, enriquecimento de contatos e prospecção.

Este endpoint permite recuperar endereços de e-mail por solicitação fornecendo detalhes como nome e domínio. O primeiro resultado encontrado será fornecido como resposta, cada solicitação desconta dez créditos.

Autenticação

Para acessar a API, você precisa de uma chave API válida. Você pode gerar sua chave API pessoal na seção API após fazer login em sua conta. Esta chave é necessária para autenticação e fazer requisições de forma segura.

Endpoint da API

URL

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

Exemplo de Resposta se o e-mail for encontrado

Você receberá uma resposta idêntica caso o e-mail seja encontrado

Resposta se encontrado

{
  "email": "[email protected]",
  "status": "found"
}

Exemplo de Resposta se o e-mail não for encontrado

Você receberá uma resposta idêntica caso o e-mail seja encontrado

Resposta se não encontrado

{
  "email": "null",
  "status": "not_found"
}

Verificações Realizadas no Localizador de E-mail

Verificação de Combinações: Verifique o nome fornecido em vinte e cinco combinações junto com o domínio e identifique qual resulta em um endereço de e-mail válido.

Validação MX: Verifique registros MX válidos para confirmar se o domínio do e-mail está configurado para receber mensagens, garantindo que exista e esteja ativo.

Validação de Lista Negra MX: Identifique domínios listados em listas negras conhecidas para spam ou atividades maliciosas, ajudando você a evitar destinos de e-mail não confiáveis ou prejudiciais.

Validação SMTP: Realize verificação em tempo real pingando o servidor SMTP do destinatário para confirmar se o endereço de e-mail está ativo e pode receber mensagens.

Respostas de Erro

Mensagem de Erro

Descrição

Chave API Inválida

Se a chave estiver desativada ou não existir

Requisição Inválida

Parâmetros inválidos no endpoint da API

0 créditos restantes

O usuário não possui créditos

Domínios gratuitos estão bloqueados

Quando o usuário tenta encontrar e-mail de um domínio gratuito

Verificar Saldo da Conta

Use a seguinte requisição GET para verificar o saldo atual da conta (créditos diários e instantâneos restantes).

URL da Requisição GET (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance?key=<Sua_chave_de_API>

Aqui, substitua <Sua_chave_de_API> pela sua chave API ativa.

Resposta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}