API de verificación de dominios de email
Verifica el lado del dominio de una dirección: ¿está activo?, ¿es un proveedor gratuito?, ¿es un dominio de empresa?, ¿es catch-all? Todo en una sola llamada.
Qué comprueba Mailbeam
Cada verificación ejecuta 7 comprobaciones en paralelo y devuelve un resultado estructurado en menos de 100 ms.
Detección de proveedores de email gratuitos
La marca `free_provider` de la respuesta identifica las direcciones de Gmail, Yahoo, Outlook y otros proveedores de consumo. Úsala para exigir email corporativo en productos B2B.
Marca de dominio catch-all
El booleano `catch_all` identifica los dominios cuyo servidor acepta todas las direcciones. Junto con la puntuación acotada, te permite tomar decisiones con matiz sobre dominios corporativos catch-all.
Detección de dominios desechables
La marca `disposable` caza los servicios de usar y tirar a nivel de dominio. Una dirección desechable se rechaza siempre, sea cual sea la respuesta SMTP.
Validación de registros MX
El booleano `mx_check` confirma que el dominio tiene infraestructura de correo activa. Los dominios de empresas desaparecidas, los aparcados y los caducados fallan esta comprobación.
Contribución del dominio a la puntuación
Las señales de reputación del dominio —antigüedad, histórico de MX, registro corporativo conocido— contribuyen a la puntuación de calidad global. Una señal de dominio sólida sube la puntuación incluso cuando el sondeo SMTP no es concluyente.
Una llamada, todos los campos de dominio
Todas las comprobaciones a nivel de dominio se ejecutan en el endpoint de verificación estándar. No hay un endpoint solo de dominio: el resultado completo incluye información de dominio y de buzón.
Cómo funciona
Se extrae el dominio del email
El componente de dominio de la dirección se analiza y se normaliza para todas las comprobaciones posteriores.
Clasificación del proveedor
El dominio se comprueba contra la lista de proveedores gratuitos, la base de dominios desechables y las señales de registro de dominios corporativos conocidos.
Comprobación de MX y catch-all
La consulta DNS de MX confirma que el dominio tiene infraestructura de correo. El sondeo SMTP determina si el dominio es catch-all.
Se devuelven los campos de dominio
La respuesta incluye `free_provider`, `disposable`, `catch_all`, `mx_check` y la `score` influida por el dominio, lista para la lógica de tu aplicación.
Intégralo en minutos
// Todavía no hay SDK: el wrapper de 12 líneas de /docs/quickstart.
import { verifyEmail } from "@/lib/mailbeam";
// Exige email corporativo en el flujo de invitación a un equipo B2B
export async function validateTeamMemberEmail(email, allowedDomain) {
const result = await verifyEmail(email);
if (!result.mx_check) {
return { ok: false, error: "El dominio del email no tiene servidores de correo activos." };
}
if (result.disposable) {
return { ok: false, error: "No se admiten direcciones de email temporales." };
}
if (result.free_provider) {
return {
ok: false,
error: `Usa tu email corporativo de ${allowedDomain} para unirte a este espacio de trabajo.`,
};
}
// Opcional: exige un dominio concreto en los planes de equipo
const domain = email.split("@")[1].toLowerCase();
if (allowedDomain && domain !== allowedDomain) {
return {
ok: false,
error: `Solo las direcciones @${allowedDomain} pueden unirse a este espacio de trabajo.`,
};
}
return { ok: true, score: result.score };
}Cuándo usarlo
Exigir email corporativo en productos B2B
Usa `free_provider: true` para bloquear direcciones de Gmail, Yahoo y Outlook en planes enterprise. Exige un dominio de empresa para invitar a un equipo o crear un espacio de trabajo.
Cualificar leads por tipo de dominio
Puntúa los leads entrantes de forma distinta según el tipo de dominio: dominio corporativo (mucho valor), proveedor gratuito (medio), catch-all con puntuación alta (incluir), catch-all con puntuación baja (suprimir).
Detectar dominios de empresas desaparecidas
Cuando una empresa cierra o es adquirida, su dominio de correo suele perder los registros MX. Un fallo de MX a nivel de dominio es una señal fiable de un email de empresa que ya no funciona.
Listas de dominios permitidos para planes de equipo
Combina las comprobaciones de MX y catch-all de Mailbeam con tu propia lista de dominios permitidos para asegurar que todos los miembros de un espacio de trabajo se registran con el mismo dominio de empresa.
Preguntas frecuentes
¿Listo para integrarlo?
El plan gratuito incluye 1.000 verificaciones al mes. Sin tarjeta de crédito.