API de verificación masiva de emails
Envía hasta 500.000 direcciones en una sola llamada. Recibe puntuaciones por dirección, clasificación de estado y marcas de entrega, sin que expire la conexión.
Qué comprueba Mailbeam
Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.
500.000 direcciones por trabajo
Un único POST a /v1/verify/batch acepta hasta 500.000 direcciones de email. Los trabajos se encolan y se procesan de forma asíncrona: sin tiempos de espera HTTP ni resultados parciales.
Webhook firmado al completarse
Registra un endpoint una vez en el panel. Cuando un trabajo termina, Mailbeam envía por POST un evento batch.completed con los totales y una URL de descarga, firmado con HMAC-SHA256 para que puedas comprobar que viene de nosotros.
Puntuación por dirección
Cada dirección del lote recibe el mismo tratamiento que en el endpoint de verificación individual: sintaxis, MX, SMTP, desechables, rol, detección de catch-all y puntuación de calidad.
Segmentación entregable / arriesgado / no entregable
Los resultados incluyen un campo de estado por dirección. Filtra la salida JSON por estado para crear segmentos listos para enviar, de revisión y de supresión.
Consulta de progreso
Consulta /v1/jobs/{jobId} en cualquier momento para saber cuántas direcciones se han procesado. O simplemente espera al webhook: lo que mejor encaje en tu flujo.
Una conexión por dominio de destino
Las direcciones se agrupan por dominio y cada dominio se sondea de una en una, mientras que dominios distintos van en paralelo. Es más lento que martillear un servidor de correo, y es lo que mantiene nuestras IP —y por tanto tus resultados— fuera de las listas de bloqueo.
Cómo funciona
Haz POST del array de emails
Envía un cuerpo JSON con un array `emails` —hasta 500.000 cadenas— a /v1/verify/batch. La respuesta devuelve un `job_id` de inmediato, con un 202.
Empieza el procesamiento asíncrono
Mailbeam procesa cada dirección de forma independiente: comprobación de sintaxis, consulta DNS/MX, sondeo SMTP, comprobación contra la base de desechables, detección de rol y puntuación de catch-all.
Se dispara el webhook (o consultas tú)
Cuando todas las direcciones se han procesado, tu endpoint recibe un evento `batch.completed` firmado. Como alternativa, consulta el progreso en /v1/jobs/{jobId}.
Recupera y segmenta los resultados
Descarga /v1/jobs/{jobId}/results en CSV, o añade ?format=json para obtener filas con `index`, `email`, `status`, `score` y `reason`. Filtra por estado para construir tus segmentos. Los resultados se conservan 72 horas y después se borran.
Intégralo en minutos
const auth = { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` };
// Crea un trabajo por lotes: devuelve un 202 de inmediato
const job = await fetch("https://api.mailbeam.dev/v1/verify/batch", {
method: "POST",
headers: { ...auth, "Content-Type": "application/json" },
body: JSON.stringify({
emails: ["alice@example.com", "bob@company.io" /* hasta 500.000 */],
}),
}).then((r) => r.json());
console.log(`Trabajo ${job.job_id} en cola — ${job.total} direcciones`);
// Espera el webhook batch.completed, o consulta:
const status = await fetch(
`https://api.mailbeam.dev/v1/jobs/${job.job_id}`,
{ headers: auth }
).then((r) => r.json());
// Después descarga la lista limpia (CSV por defecto)
const csv = await fetch(status.download_url, { headers: auth }).then((r) =>
r.text()
);Cuándo usarlo
Limpieza de listas antes de una campaña
Pasa todas tus listas por la API por lotes antes de enviar una campaña. Suprime las direcciones no entregables para mantener el rebote por debajo del umbral del 2 % de los proveedores.
Validación de importaciones al CRM
Verifica los contactos antes de importarlos desde exportaciones de ferias, hojas de cálculo o fuentes de leads de terceros. Al CRM entran datos limpios; los inválidos no entran nunca.
Reverificación trimestral de la base de datos
Las direcciones B2B se degradan alrededor de un 25 % al año. Programa un trabajo por lotes trimestral contra tu base completa de usuarios o contactos para identificar las que han caducado.
Preparación de campañas de reactivación
Los segmentos inactivos son los que más se degradan. Verifica antes de cualquier envío de recuperación para suprimir las direcciones inválidas y evitar el daño de entregabilidad que provocan los rebotes.
Preguntas frecuentes
¿Listo para integrarlo?
El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.