API de verificación de email en tiempo real
Verifica cualquier dirección en menos de 100 ms, lo bastante rápido para validar mientras el usuario sigue en el formulario. Siete comprobaciones en paralelo, un único resultado estructurado.
Qué comprueba Mailbeam
Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.
Tiempo de respuesta p99 por debajo de 100 ms
Los registros MX de los dominios europeos y estadounidenses más comunes están precalentados en la caché de Mailbeam. La mayoría de verificaciones terminan en 40-80 ms. En el peor caso (dominio frío, servidor lento) se mantiene por debajo de 500 ms.
Siete comprobaciones en paralelo
Sintaxis, MX, sondeo SMTP, detección de desechables, detección de rol e identificación de catch-all se ejecutan de forma concurrente, no secuencial.
Sugerencias de errata en la respuesta
Cuando un usuario escribe «gmal.com», la respuesta incluye `suggestion: 'gmail.com'`. Muéstralo en línea antes de que se envíe el formulario y recupera el lead en vez de perderlo.
Resultado JSON estructurado
Un único objeto de respuesta incluye `valid`, `score` (0-100), `status`, `disposable`, `role`, `suggestion` y un booleano por comprobación. Una llamada, todos los datos que necesitas.
Modo sandbox para pruebas
Usa los dominios @valid.mailbeam-test.dev y @invalid.mailbeam-test.dev en tus tests. Las llamadas de verificación devuelven resultados deterministas sin consumir cuota.
Alojada en la UE, conforme al RGPD
Toda la verificación se ejecuta en Fráncfort, Alemania. Las direcciones no se almacenan tras una comprobación en tiempo real; las listas y resultados de los lotes se conservan 72 horas y después se borran. Apta para tratar datos de usuarios europeos conforme al artículo 28 del RGPD.
Cómo funciona
Haz POST del email al enviarse el formulario
Envía la dirección a /v1/verify con una petición POST desde el manejador de registro de tu backend. No llames a la API desde el navegador: mantén tu clave de API en el servidor.
Se ejecutan las comprobaciones en paralelo
La validación de sintaxis, la consulta de registros MX (desde la caché si está disponible), el sondeo SMTP del buzón, la comprobación de la base de desechables, la detección de prefijos de rol y la detección de catch-all se ejecutan de forma concurrente.
El resultado llega en menos de 100 ms
Para dominios cacheados, la respuesta completa —incluida la puntuación por IA— vuelve en 40-80 ms. El usuario no percibe ningún retraso.
Responde al usuario en línea
Usa el booleano `valid` para aceptar o rechazar el envío. Usa `suggestion` para mostrar una propuesta de corrección. Usa `score` para aplicar tu propio umbral de calidad en los casos límite.
Intégralo en minutos
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
type VerifyRequest struct {
Email string `json:"email"`
}
type VerifyResult struct {
Valid bool `json:"valid"`
Score int `json:"score"`
Disposable bool `json:"disposable"`
Role bool `json:"role"`
Suggestion *string `json:"suggestion"`
Status string `json:"status"`
}
func verifyEmail(email string) (*VerifyResult, error) {
body, _ := json.Marshal(VerifyRequest{Email: email})
req, _ := http.NewRequest("POST", "https://api.mailbeam.dev/v1/verify", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("MAILBEAM_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var result VerifyResult
json.NewDecoder(resp.Body).Decode(&result)
return &result, nil
}
func handleSignup(email string) error {
result, err := verifyEmail(email)
if err != nil || !result.Valid {
if result != nil && result.Suggestion != nil {
return fmt.Errorf("¿quisiste decir %s?", *result.Suggestion)
}
return fmt.Errorf("dirección de email no válida")
}
if result.Disposable {
return fmt.Errorf("no se admiten direcciones de email temporales")
}
return nil
}Cuándo usarlo
Formularios de registro de usuarios
Bloquea los emails falsos y mal escritos antes de que entren en tu base de usuarios. Caza las direcciones desechables y muestra correcciones de errata en línea.
Campos de email del checkout de e-commerce
Asegura que la confirmación del pedido llega al cliente. Una comprobación de 100 ms en el checkout evita la causa más habitual de los tickets del tipo «no me ha llegado la confirmación».
Altas en newsletters y listas de espera
Protege la calidad de la lista desde el primer día. Una comprobación en tiempo real en el alta garantiza que todo suscriptor es entregable antes de entrar en tu plataforma de envío.
Formularios de solicitud de demo B2B
Bloquea las direcciones de rol y desechables en los formularios de conversión de mayor valor. Usa la marca `role` para encaminar las direcciones info@ a revisión manual en lugar de a secuencias automatizadas.
Preguntas frecuentes
¿La verificación ralentizará mi formulario de registro?
No. Con un p99 por debajo de 100 ms, la verificación termina antes que la ida y vuelta de red de la mayoría de envíos de formulario. Los usuarios no perciben ningún retraso adicional.
¿Verifico en el frontend o en el backend?
Llama siempre a la API desde tu backend, nunca desde JavaScript del navegador. Así tu clave de API se mantiene en secreto y la comprobación no se puede esquivar con un script del lado del cliente.
¿Qué hago si Mailbeam devuelve el estado «unknown»?
«Unknown» significa que Mailbeam no ha podido determinar la entregabilidad con confianza, normalmente porque el servidor de correo bloquea los sondeos SMTP (habitual en Google y Microsoft). El campo `score` da un indicador de confianza. Para direcciones desconocidas con una puntuación de 50 o más, plantéate permitir el registro y vigilar los rebotes.
¿Puedo usar la verificación en tiempo real junto con enlaces de confirmación por email?
Sí, y lo recomendamos. La verificación en tiempo real caza erratas y emails desechables al instante. Los enlaces de confirmación comprueban que el usuario controla el buzón. Usa las dos cosas para tener la base de usuarios de mayor calidad.
¿Listo para integrarlo?
El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.