Mailbeam
API · Desarrollo

API de verificación de email para desarrolladores

Un solo endpoint REST. Verifica cualquier email en menos de 100 ms. Alojada en la UE, conforme al RGPD y con ejemplos para Node, Python, PHP, Ruby y Go.

¿Qué es una API de verificación de email?
Una API de verificación de email es un endpoint HTTP que te dice si una dirección de correo es real y entregable antes de que le escribas. Mailbeam ejecuta ocho comprobaciones sobre cada dirección —sintaxis, registros MX, existencia SMTP, dominios desechables, direcciones de rol, proveedores gratuitos, dominios catch-all y una puntuación de calidad— y devuelve un veredicto, una puntuación sobre 100 y un código de motivo legible por máquina sobre el que tu aplicación puede decidir.

Qué comprueba Mailbeam

Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.

Respuesta en menos de 100 ms

Verifica emails en tiempo real durante el registro sin añadir latencia perceptible al flujo de tus usuarios.

Verificación SMTP en vivo

Conectamos directamente con el servidor de correo y confirmamos que el buzón existe, no solo que el dominio tiene registros MX.

Alojada en la UE, RGPD primero

Todo el procesamiento ocurre en infraestructura europea. Sin retención de datos tras la verificación. DPA disponible para el artículo 28.

Ejemplos para cualquier stack

Node.js, Python, PHP, Ruby y Go. Es un POST con un JSON: una docena de líneas de tu cliente HTTP habitual y ya está integrado.

Detección de desechables y buzones de rol

Bloquea direcciones de usar y tirar y buzones de departamento (info@, admin@) con una base de datos que se actualiza de forma continua.

Sugerencia de errores tipográficos

Cuando alguien escribe «gmal.com», devolvemos «gmail.com» al instante para que lo corrija antes de enviar el formulario.

Cómo funciona

1

Envía una petición POST

Manda la dirección a /v1/verify con tu API key en la cabecera Authorization. Eso es todo.

2

Consulta de DNS y registros MX

Mailbeam consulta el DNS del dominio para confirmar que puede recibir correo.

3

Handshake SMTP

Conectamos con el servidor de correo y simulamos un intento de entrega para confirmar que ese buzón concreto existe.

4

Resultado JSON estructurado

Recibes un JSON con el estado (deliverable/risky/undeliverable/unknown), una puntuación de 0 a 100 y el resultado de cada comprobación.

Intégralo en minutos

cURLbash
curl -X POST https://api.mailbeam.dev/v1/verify \
  -H "Authorization: Bearer $MAILBEAM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "usuario@ejemplo.com"}'

# Respuesta:
# {
#   "email": "usuario@ejemplo.com",
#   "status": "deliverable",
#   "score": 97,
#   "valid": true,
#   "disposable": false,
#   "role": false,
#   "suggestion": null
# }

Cuándo usarlo

Formularios de registro

Valida en el momento del alta para frenar los emails falsos y mal escritos antes de que entren en tu sistema.

Integraciones por API

Verifica emails desde cualquier backend: un POST con cuerpo JSON, sin librería cliente obligatoria.

Webhooks y flujos asíncronos

Envía una lista al endpoint por lotes y deja que un webhook firmado batch.completed te avise cuando esté lista, en vez de hacer polling.

Enriquecimiento de CRM

Añade estado de verificación y puntuación a tus contactos para alimentar el lead scoring y el enrutado comercial.

Preguntas frecuentes

¿Cómo de rápida es la API?

Mailbeam responde en menos de 100 ms en el percentil 99 para la mayoría de dominios. La verificación SMTP de dominios desconocidos puede llegar a 500 ms cuando el servidor tarda en contestar.

¿Hay SDK oficiales?

Todavía no: las librerías oficiales para Node.js, Python, PHP, Ruby y Go están en la hoja de ruta y la API REST llega primero. Es un único POST con cuerpo JSON, así que bastan unas líneas de tu cliente HTTP; la guía de inicio rápido incluye un wrapper para copiar en cada lenguaje.

¿Existe un plan gratuito?

Sí. El plan gratuito incluye 1.000 verificaciones al mes sin tarjeta de crédito, suficiente para integrar y probar en producción.

¿La API almacena las direcciones de email?

En la verificación en tiempo real no: la dirección se descarta en cuanto se devuelve la respuesta. La excepción son los trabajos por lotes, cuya lista y resultados se conservan 72 horas para que puedas descargarlos y después se borran automáticamente. Mailbeam cumple el RGPD y está alojado en la UE.

¿Qué SLA ofrecéis?

El SLA contractual llega con los planes de pago. El estado en vivo de cada componente, comprobado en cada carga de página, está en mailbeam.dev/status.

¿Listo para integrarlo?

El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.