Docs/Buscador de emails

API Email Finder

Encuentra un email profesional verificado a partir del nombre, el apellido y el dominio de la empresa.

Ver Markdown OpenAPI JSON
Regla de facturación

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

  1. Tú envías first_name, last_name, y domain.
  2. VeriMails comprueba el nombre y el dominio facilitados en busca de un buzón verificado a nivel de persona.
  3. Solo se devuelve un resultado tras la verificación en vivo.
  4. Si no se puede confirmar un buzón verificado, la API devuelve not_found o catch_all.
  5. En las búsquedas de personas, VeriMails devuelve una dirección verificada a nivel de persona cuando se puede confirmar.

Encuentra un email

POST /api/find-email

Úsalo para búsquedas una a una desde tu aplicación o las herramientas de tu equipo.

CampoObligatorioDescripción
first_nameSíNombre de la persona.
last_nameSíApellido de la persona.
domainSíDominio de la empresa, como acme.com. La API normaliza las URLs.
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
}

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
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.

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

El CSV de salida añade found_email, finder_status, finder_confidence, y finder_elapsed_ms.

Estados

EstadoSignificadoFacturación
foundSe encontró un email verificado.Se cobra
not_foundNo se encontró ningún email verificado a nivel de persona.Sin cargo
catch_allEl dominio acepta direcciones genéricas, así que no se puede confirmar el buzón.Sin cargo
invalid_inputFaltan campos obligatorios de nombre o dominio.Sin cargo
insufficient_creditsTu cuenta no tiene suficientes créditos para la capacidad de la solicitud.Sin cargo