API do Localizador de E-mails
Encontre um e-mail profissional verificado a partir do nome, sobrenome e domínio da empresa.
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
- Você envia
first_name,last_name, edomain. - O VeriMails verifica o nome e o domínio informados em busca de uma caixa de e-mail verificada de uma pessoa.
- Um resultado só é retornado após a verificação ao vivo.
- Se não for possível confirmar uma caixa verificada, a API retorna
not_foundoucatch_all. - Em buscas de pessoas, o VeriMails retorna um endereço verificado da pessoa quando é possível confirmá-lo.
Encontre um e-mail
Use para buscas uma a uma a partir da sua aplicação ou das ferramentas do seu time.
| Campo | Obrigatório | Descrição |
|---|---|---|
first_name | Sim | Nome da pessoa. |
last_name | Sim | Sobrenome da pessoa. |
domain | Sim | Domínio da empresa, como acme.com. URLs são normalizadas pela API. |
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"}'
{
"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 -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.
first_name,last_name,domain
Jane,Doe,company.com
Sam,Lee,example.com
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
| Status | Significado | Cobrança |
|---|---|---|
found | Um e-mail verificado foi encontrado. | Cobrado |
not_found | Nenhum e-mail pessoal verificado foi encontrado. | Sem cobrança |
catch_all | O domínio aceita endereços genéricos, então a caixa de entrada não pode ser confirmada. | Sem cobrança |
invalid_input | Faltam campos obrigatórios de nome ou domínio. | Sem cobrança |
insufficient_credits | Sua conta não tem créditos suficientes para a capacidade da solicitação. | Sem cobrança |