API Email Finder
Encuentra un email profesional verificado a partir del nombre, el apellido y el dominio de la empresa.
Email Finder cuesta 20 créditos solo cuando se encuentra un email verificado. Los casos sin resultado verificado, las entradas inválidas y los resultados catch-all no se cobran. Las peticiones masivas y por CSV requieren créditos suficientes en ese momento para los emails verificados que pueda devolver el trabajo.
Cómo funciona
- Tú envías
first_name,last_name, ydomain. - VeriMails comprueba el nombre y el dominio facilitados en busca de un buzón verificado a nivel de persona.
- Solo se devuelve un resultado tras la verificación en vivo.
- Si no se puede confirmar un buzón verificado, la API devuelve
not_foundocatch_all. - En las búsquedas de personas, VeriMails devuelve una dirección verificada a nivel de persona cuando se puede confirmar.
Encuentra un email
Úsalo para búsquedas una a una desde tu aplicación o las herramientas de tu equipo.
| Campo | Obligatorio | Descripción |
|---|---|---|
first_name | Sí | Nombre de la persona. |
last_name | Sí | Apellido de la persona. |
domain | Sí | Dominio de la empresa, como acme.com. La API normaliza las URLs. |
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
}
Encuentra hasta 100 emails de forma síncrona
Usa el endpoint masivo síncrono para lotes pequeños. Los archivos más grandes deben usar el flujo de CSV que se describe a continuación.
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"}
]
}'
Email Finder por CSV
Sube un CSV cuando necesites encontrar emails a escala. El CSV debe incluir columnas de nombre, apellido y dominio. Los alias admitidos incluyen firstname, lastname, company_domain, website, y 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
El CSV de salida añade found_email, finder_status, finder_confidence, y finder_elapsed_ms.
Estados
| Estado | Significado | Facturación |
|---|---|---|
found | Se encontró un email verificado. | Se cobra |
not_found | No se encontró ningún email verificado a nivel de persona. | Sin cargo |
catch_all | El dominio acepta direcciones genéricas, así que no se puede confirmar el buzón. | Sin cargo |
invalid_input | Faltan campos obligatorios de nombre o dominio. | Sin cargo |
insufficient_credits | Tu cuenta no tiene suficientes créditos para la capacidad de la solicitud. | Sin cargo |