API de validación de correo en tiempo real para formularios de registro

Valida las direcciones cuando los usuarios las envían: el servidor de correo y si el buzón existe en una sola llamada, con indicadores de desechable y de rol para que decidas qué aceptar. Nuestra API de validación de correo bloquea los datos malos antes de que entren y mantiene las cuentas falsas fuera de tu base de datos.

Gestor de registro en el backendDecisión del formulario
// 1. Receive submitted form data
const { email } = req.body;

// 2. Validate via API
const { data } = await checkEmail(email);

// 3. Make real-time form decision
if (data.status === 'undeliverable') {
  return res.status(400).json({ error: 'Please enter a valid, active email address.' });
}
if (data.details.attributes.disposable) {
  return res.status(400).json({ error: 'Temporary or disposable emails are not allowed.' });
}

// 4. Proceed with account registration
await createUser({ email });

1.000 créditos gratis, sin tarjeta. Los créditos no caducan.

Por qué una regex por sí sola no es validación de correo

Una expresión regular solo comprueba la estructura del texto: si hay una @, si el formato del dominio parece plausible y si los caracteres están dentro de los rangos ASCII estándar. Una regex solo responde si una entrada parece una dirección de correo, no si alguien puede recibir mensajes en ella.

Escribir user@example.com o asdf12345@gmail.com pasa sin problema cualquier regex que cumpla el RFC. Sin embargo, uno de los dominios puede no tener servidores de correo activos, y el otro buzón puede no existir.

Nuestra API de validación de correo con respuesta JSON va mucho más allá de las expresiones regulares. En una sola solicitud revisa los registros DNS, consulta los servidores MX, se conecta al servidor de correo de destino para probar si el buzón responde y compara el dominio con amplias listas de dominios desechables.

Los patrones regex rígidos también causan rechazos falsos. Las expresiones personalizadas suelen rechazar dominios de nivel superior poco comunes como .studio o .cloud, caracteres internacionales válidos o direcciones legítimas con puntuación poco habitual. Nuestra API maneja automáticamente toda la sintaxis de RFC 5322, así que no tienes que mantener frágiles bibliotecas de regex en tu código.

1

Comprobación de sintaxis

Detecta errores de escritura básicos, TLD que faltan, puntuación no permitida y espacios antes de cualquier consulta de red externa.

2

Verificación DNS y MX

Comprueba que el dominio está registrado y encuentra los servidores de correo configurados que pueden aceptar mensajes entrantes.

3

Comprobación del buzón

Se comunica directamente con el servidor de correo remoto para confirmar si ese buzón existe y puede recibir correo.

Qué bloquear, marcar o permitir en el registro

Cada negocio tiene requisitos de registro distintos. Un SaaS B2B para empresas puede exigir correos corporativos, mientras que una app social de consumo acepta direcciones personales de Gmail. Esta es la tabla de decisiones recomendada según los atributos reales de la respuesta de la API:

Resultado de la APICondición del campoQué debe hacer el formulario
No válidostatus === "undeliverable"Bloquear de inmediato. Mostrar: "Escribe una dirección de correo válida y activa."
Desechabledetails.attributes.disposable === trueBloquear o pedir otra dirección. Mostrar: "No se permiten direcciones de correo temporales."
Cuenta de roldetails.attributes.role_account === truePermitir; marcar en formularios B2B. Avisar a los gestores de cuenta o enviar al grupo general de leads.
Correo gratuitodetails.attributes.free_email === truePermitir en apps B2C; exigir un correo corporativo en formularios de demo o de prueba B2B.
Catch-alldetails.attributes.catch_all === trueRevisar catch_all_verdict: si es "valid", permitir; si es "invalid", bloquear; si es null, permitir el registro.
Desconocidostatus === "unknown"Aceptar y volver a comprobar más tarde (se reembolsa). Si falla, dejar pasar (fail-open), así nunca se bloquea a usuarios legítimos.

Añade validación de correo a tu formulario de registro

Sigue esta secuencia de cuatro pasos para integrar la validación en tiempo real de forma segura. Como las solicitudes necesitan tu clave de API privada, haz la comprobación desde tu servidor backend.

Por qué importa el patrón fail-open: los formularios de registro son sensibles a los retrasos. Si una llamada a una API externa sufre latencia de red, bloquear el formulario puede hacerte perder a un cliente real. Si usas un tiempo de espera corto y dejas que el registro siga automáticamente, no rechazas a usuarios legítimos, y tu backend pone la dirección en cola para comprobarla más tarde en segundo plano.

1

El formulario envía los datos a tu backend

Cuando un visitante envía sus datos de registro, el navegador transmite la dirección de correo al endpoint de tu aplicación.

2

El backend llama a la API de validación

Tu servidor envía una solicitud POST síncrona a Giggal con tu clave privada guardada en una variable de entorno.

3

El backend aplica la tabla de decisiones

Lee los atributos del JSON. Si el correo es desechable o no entregable, devuelve al navegador un mensaje de error claro.

4

Dejar pasar si se agota el tiempo

Si la comunicación con la API agota el tiempo de espera, aplica fail-open: acepta el registro y pon en cola una tarea en segundo plano para verificarlo más tarde.

Ejemplos de código de implementación

Backend: Node.js (ruta de Express)solo en el servidor
// server.js (Express Route)
const timeoutMs = 5000; // adjust to what your form can tolerate

app.post('/api/signup', async (req, res) => {
  const { email, password } = req.body;

  try {
    const apiRes = await fetch('https://api.giggal.ai/v1/verify', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email }),
      signal: AbortSignal.timeout(timeoutMs), // fail-open timeout
    });

    const result = await apiRes.json();
    if (result.success) {
      const { status, details } = result.data;

      // Decision checks
      if (status === 'undeliverable') {
        return res.status(400).json({ error: 'This email address does not exist.' });
      }
      if (details.attributes.disposable) {
        return res.status(400).json({ error: 'Disposable email addresses are not accepted.' });
      }
    }
  } catch (err) {
    // Fail open: log timeout and let user proceed
    console.warn('Email check timed out, failing open:', err.message);
  }

  // Create user in database
  const user = await db.users.create({ email, password });
  return res.json({ success: true, userId: user.id });
});
Backend: Python (ruta de Flask)solo en el servidor
# app.py (Flask Route)
import os, requests
from flask import Flask, request, jsonify

app = Flask(__name__)
timeout_seconds = 5  # adjust to what your form can tolerate

@app.route("/api/signup", methods=["POST"])
def signup():
    email = request.json.get("email")

    try:
        resp = requests.post(
            "https://api.giggal.ai/v1/verify",
            headers={"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}"},
            json={"email": email},
            timeout=timeout_seconds  # fail open on timeout
        )
        data = resp.json().get("data", {})
        if data.get("status") == "undeliverable":
            return jsonify({"error": "Email address is invalid."}), 400
        if data.get("details", {}).get("attributes", {}).get("disposable"):
            return jsonify({"error": "Disposable emails are prohibited."}), 400
    except requests.exceptions.RequestException:
        # Fail open: proceed with signup on timeout
        pass

    # Complete user registration
    return jsonify({"success": True})
Frontend: cliente del navegador (llama a tu propio backend)script del cliente
// Frontend form submit handler
const form = document.querySelector('#signup-form');

form.addEventListener('submit', async (e) => {
  e.preventDefault();
  const email = document.querySelector('#email-input').value;

  const res = await fetch('/api/signup', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ email }),
  });

  const payload = await res.json();
  if (!res.ok) {
    showFormError(payload.error); // Show friendly user feedback
  } else {
    redirectToDashboard();
  }
});

Importante: nunca llames al endpoint de la API de Giggal directamente desde scripts del cliente. Mantén tus credenciales privadas en tu servidor.

Frena los registros desechables y falsos

Los buzones temporales distorsionan la analítica de tu producto, gastan las cuotas de prueba gratuita y nunca se convierten en clientes de pago. Nuestro servicio detecta y marca los patrones de registro de alto riesgo.

Buzones desechables

Se comparan con nuestro registro activo de más de 100.000 dominios temporales. Mira cómo identificamos los buzones de usar y tirar con nuestro verificador de correos desechables.

Detección de alias con signo más

Marca los alias creados con el signo más (user+trial@domain.com), para que una misma persona no cree varias cuentas de prueba.

Detección de buzones no-reply

Detecta los buzones automáticos y de difusión que descartan los mensajes entrantes, para que nadie se registre con direcciones que no responden.

No corrijas automáticamente los errores de escritura

Nunca cambies en silencio lo que escribe el usuario (por ejemplo, cambiar gnail.com por gmail.com de forma automática). Si una dirección no pasa la validación, muestra un mensaje claro para que el usuario revise lo que escribió. Si reescribes en silencio, puedes enviar enlaces de activación de cuenta o recibos de pago a otra persona.

Dónde validar correos en tiempo real

Valida las direcciones de correo en cualquier formulario de tu producto donde los usuarios envían datos.

Formularios de registro de usuarios

Evita el spam de registros y ayuda a que los correos de bienvenida y los enlaces de verificación lleguen a buzones activos.

Pago en tiendas online

Asegura que los avisos de envío, los recibos y las confirmaciones de pedido lleguen a los clientes sin fallos de entrega.

Solicitudes de contacto y de demo

Filtra las entradas falsas de la competencia y verifica los dominios de empresa antes de pasar los contactos a los comerciales.

Suscripciones a newsletters

Protege la reputación de tu dominio de envío: rechaza las entradas mal formadas y los registros de bots en el alta.

Automatizaciones con webhooks

Lanza la validación automáticamente desde los webhooks de tus formularios con nuestras integraciones de Zapier y n8n.

Cambios en el perfil de la cuenta

Verifica las nuevas direcciones cuando los usuarios cambian su perfil o su contacto de facturación.

Campos de la respuesta que usarás en el registro

Una referencia breve de los campos JSON principales que necesitas para aplicar la lógica de validación del formulario.

Campo JSONTipoUso en el registro
data.is_validbooleanComprobación booleana rápida. Es true cuando pasan las comprobaciones del dominio y del buzón.
data.statusstringEstado de entrega principal: "deliverable", "undeliverable", "unknown".
data.deliverability_scorenumber (0-100)Puntuación de calidad basada en las respuestas del buzón, la estabilidad de los MX y las comprobaciones de reputación.
data.details.attributes.disposablebooleanEs true cuando el dominio es un servicio conocido de buzones temporales o desechables.
data.details.attributes.free_emailbooleanEs true en proveedores de consumo (Gmail, Outlook). Exige dominios corporativos en formularios B2B.
data.details.attributes.role_accountbooleanEs true en direcciones de organización como info@, admin@ o support@.
data.catch_all_verdict"valid" | "invalid" | nullResolución de los dominios catch-all en la misma llamada. Recupera contactos válidos sin descartarlos.

Para ver todas las definiciones de endpoints, los esquemas de parámetros y los códigos de error, consulta la referencia completa de la API.

Precios de la API de validación de correo

Paga solo por las validaciones que haces, sin mínimos mensuales ni compromisos. Cada llamada de validación a la API consume 1 crédito, con las comprobaciones catch-all incluidas en la misma llamada. Los resultados desconocidos se reembolsan automáticamente y tus primeros 1.000 créditos son totalmente gratis.

Créditos
3000créditos
Precio0,0017 $ / crédito
Ahorro
-
Total
5,00 $una sola vez
Créditos
10.000créditos
Precio0,0010 $ / crédito
Ahorro
Ahorras un 41 %
Total
9,90 $una sola vez
Créditos
30.000créditos
Precio0,0009 $ / crédito
Ahorro
Ahorras un 44 %
Total
28,00 $una sola vez
Créditos
50.000créditos
Precio0,0008 $ / crédito
Ahorro
Ahorras un 53 %
Total
39,00 $una sola vez
Créditos
100.000créditosEl más elegido
Precio0,0008 $ / crédito
Ahorro
Ahorras un 54 %
Total
76,00 $una sola vez
Créditos
300.000créditos
Precio0,0007 $ / crédito
Ahorro
Ahorras un 56 %
Total
222,00 $una sola vez
Créditos
500.000créditos
Precio0,0007 $ / crédito
Ahorro
Ahorras un 57 %
Total
360,00 $una sola vez
Créditos
800.000créditos
Precio0,0007 $ / crédito
Ahorro
Ahorras un 58 %
Total
559,00 $una sola vez
Créditos
1.000.000créditos
Precio0,0007 $ / crédito
Ahorro
Ahorras un 59 %
Total
680,00 $una sola vez

Mira todos los planes por volumen y los descuentos de la suscripción mensual en nuestra página de precios.

Preguntas frecuentes sobre la API de validación de correo

Respuestas a preguntas habituales de implementación sobre formularios de registro y validación en tiempo real.

Sí. Cada cuenta nueva recibe 1.000 créditos gratis al registrarse, sin tarjeta de crédito. Puedes generar una clave de API en tu panel de desarrollador y empezar a probar la validación de formularios en tiempo real de inmediato. Los créditos gratis no caducan y dan acceso completo a todos los atributos y comprobaciones de validación.

No. Llamar a la API desde JavaScript del cliente expondría tu clave de API secreta a cualquiera que revise las solicitudes de red del navegador. Envía siempre los datos del formulario primero a tu propio servidor backend o a una función serverless, y haz que tu servidor envíe la solicitud a https://api.giggal.ai/v1/verify.

Nunca se envía ningún mensaje. La API comprueba si el buzón existe. Cierra la conexión antes de transmitir ningún dato ni contenido del correo, así que tus usuarios no reciben nada en su bandeja de entrada.

Sí. Cada comprobación compara el dominio con nuestro registro de más de 100.000 dominios de correo desechables y temporales. Si hay coincidencia, details.attributes.disposable devuelve true y el estado pasa a undeliverable, para que tu backend pueda bloquear las cuentas temporales.

Depende de tu modelo de negocio. En las apps de consumo, cuentas de rol como support@ o info@ pueden ser de organizaciones legítimas. En un SaaS B2B de autoservicio donde importa saber quién es cada usuario, muchas empresas marcan o no permiten las cuentas de rol genéricas para evitar el uso compartido de credenciales.

Los dominios catch-all aceptan cualquier dirección de destinatario sin condiciones, así que las comprobaciones normales no son concluyentes. Nuestra API hace una verificación catch-all a fondo en la misma llamada para saber si el buzón existe. Si la comprobación catch-all devuelve "valid", puedes permitir el registro con seguridad; si devuelve "invalid", la dirección rebotará y debes detener el registro.

Recomendamos aplicar un patrón fail-open. Si la llamada de tu backend agota el tiempo de espera o da un error de conexión, deja que el registro se complete en lugar de bloquear a un posible cliente. Pon la dirección sin validar en la cola de tu proceso en segundo plano para volver a comprobar su estado de entrega más tarde.

Elige una API de validación de correo cuando necesites comprobaciones en tiempo real en formularios web de registro para frenar errores de escritura, buzones desechables y bots al enviar el formulario. Elige una API de verificación de correo cuando revises bases de datos de marketing existentes, sincronices contactos del CRM o limpies archivos masivos de correo antes de enviar campañas.

Protege hoy tus formularios de registro

1.000 créditos gratis, sin tarjeta.

Prueba gratuita Los créditos no caducan Reembolso de los Desconocidos