Docs/Verificación masiva

Verificación masiva

Sube un CSV de direcciones de email y obtén resultados para toda tu lista.

Ver Markdown OpenAPI JSON

Resumen

La verificación masiva te permite verificar miles de direcciones de email en un solo trabajo. Sube un archivo CSV desde el panel o la API y descarga los resultados cuando termine el trabajo.

ℹ️
La verificación masiva está disponible desde el panel y la API. Sube archivos CSV con POST /api/bulk, consulta GET /api/bulk/{job_id} y después descarga los resultados desde /api/bulk/{job_id}/download.

Subida por API

Envía una subida de CSV multipart con tu clave de API. Opcionalmente puedes pasar email_column cuando el campo de email no se llama email.

bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "name=May outreach" \
  -F "email_column=Email Address"

Subida desde el panel

  1. Inicia sesión en verimails.com/dashboard
  2. Haz clic en Verificación masiva en la barra lateral
  3. Sube tu archivo CSV
  4. Espera a que termine el trabajo (aparece en tu lista de trabajos)
  5. Descarga el CSV de resultados

Formato del CSV

Tu CSV debe tener una columna con direcciones de email. VeriMails detecta automáticamente encabezados habituales como email, Email Address, work_email, y business_email. También se admiten CSV de una sola columna sin encabezado, aunque lo mejor sigue siendo un encabezado de email claro:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Las columnas adicionales se conservan en el resultado y no afectan al procesamiento.

Formatos admitidos

Formato de salida

El archivo completo de resultados conserva las columnas originales del CSV y añade una columna clara de enviabilidad:

Columna añadidaDescripción
Safe to SendYes cuando el estado verificado es válido; No para resultados inválidos, catch-all, desechables, desconocidos o riesgosos.

Consultar el estado del trabajo

En el panel, tu lista de trabajos muestra el progreso en tiempo real. Por API, consulta GET /api/bulk/{job_id} hasta que el estado del trabajo sea completed o failed.

Notificaciones por webhook

El soporte de webhooks para la finalización de trabajos masivos llegará pronto. Consulta Webhooks →

💡
Consejo: Para crear listas en tiempo real, usa la API de verificación individual para verificar las direcciones a medida que las recopilas. La verificación masiva es ideal para limpiar listas existentes.