Docs/Localizador de E-mails

API do Localizador de E-mails

Encontre um e-mail profissional verificado a partir do nome, sobrenome e domínio da empresa.

Ver Markdown OpenAPI JSON
Regra de cobrança

O Localizador de E-mails custa 20 créditos apenas quando um e-mail verificado é encontrado. Nenhum resultado verificado, entrada inválida e resultados catch-all não são cobrados. Requisições em massa e via CSV exigem créditos atuais suficientes para os e-mails verificados que o job pode retornar.

Como funciona

  1. Você envia first_name, last_name, e domain.
  2. O VeriMails verifica o nome e o domínio informados em busca de uma caixa de e-mail verificada de uma pessoa.
  3. Um resultado só é retornado após a verificação ao vivo.
  4. Se não for possível confirmar uma caixa verificada, a API retorna not_found ou catch_all.
  5. Em buscas de pessoas, o VeriMails retorna um endereço verificado da pessoa quando é possível confirmá-lo.

Encontre um e-mail

POST /api/find-email

Use para buscas uma a uma a partir da sua aplicação ou das ferramentas do seu time.

CampoObrigatórioDescrição
first_nameSimNome da pessoa.
last_nameSimSobrenome da pessoa.
domainSimDomínio da empresa, como acme.com. URLs são normalizadas pela API.
cURL
curl -X POST https://verimails.com/api/find-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Doe","domain":"company.com"}'
JSON
{
  "found": true,
  "email": "jane.doe@company.com",
  "status": "found",
  "confidence": 0.95,
  "elapsed_ms": 420
}

Encontre até 100 e-mails de forma síncrona

Use o endpoint em massa síncrono para lotes pequenos. Arquivos maiores devem usar o fluxo de CSV abaixo.

cURL
curl -X POST https://verimails.com/api/find-email/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {"first_name":"Jane","last_name":"Doe","domain":"company.com"},
      {"first_name":"Sam","last_name":"Lee","domain":"example.com"}
    ]
  }'

Localizador de E-mails via CSV

Envie um CSV quando precisar encontrar e-mails em escala. O CSV precisa incluir as colunas de nome, sobrenome e domínio. Os aliases aceitos incluem firstname, lastname, company_domain, website, e company_website.

CSV
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
cURL
curl -X POST https://verimails.com/api/find-email/csv \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv"

curl https://verimails.com/api/find-email/csv/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://verimails.com/api/find-email/csv/JOB_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY" -o finder_results.csv

O CSV de saída acrescenta found_email, finder_status, finder_confidence, e finder_elapsed_ms.

Status

StatusSignificadoCobrança
foundUm e-mail verificado foi encontrado.Cobrado
not_foundNenhum e-mail pessoal verificado foi encontrado.Sem cobrança
catch_allO domínio aceita endereços genéricos, então a caixa de entrada não pode ser confirmada.Sem cobrança
invalid_inputFaltam campos obrigatórios de nome ou domínio.Sem cobrança
insufficient_creditsSua conta não tem créditos suficientes para a capacidade da solicitação.Sem cobrança