API de verificación de correo que también resuelve las direcciones catch-all
Comprueba si cualquier buzón existe con una sola llamada REST. En los dominios catch-all, donde la mayoría de las API se quedan en "accept-all" o "arriesgado", recibes un resultado válido o no válido en la misma respuesta. Nuestra API de verificación de correo da a los equipos de desarrollo datos JSON limpios para proteger la reputación de remitente en sus flujos de prospección.
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'1.000 créditos gratis, sin tarjeta. Los créditos no caducan.
Giggal.ai está valorado como Líder en SourceForge y Slashdot
Qué devuelve una llamada a la API
Una sola llamada devuelve todos los datos de entregabilidad. Recibes el estado de entregabilidad principal, la evaluación de riesgo, una puntuación numérica de entregabilidad, los atributos del buzón y los resultados catch-all en la misma respuesta.
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}Cómo tratar los valores de estado de la respuesta
El estado de entrega principal llega en el campo status. Así debe interpretar y enrutar cada valor tu aplicación backend:
| Estado | Significado | Acción recomendada |
|---|---|---|
| deliverable | El servidor de correo de destino aceptó al destinatario en la conexión. El buzón está activo. | Se puede enviar. Inclúyelo en las campañas principales de prospección. |
| undeliverable | El buzón no existe, la sintaxis no es válida, el dominio no tiene registros MX o el dominio es desechable. | No envíes. Elimínalo de las campañas para evitar rebotes duros. |
| unknown | Respuesta del servidor no concluyente, normalmente por greylisting o por un tiempo de espera agotado. | Vuelve a comprobarlo más tarde. Los créditos de las respuestas desconocidas se reembolsan automáticamente. |
Direcciones catch-all resueltas en la misma llamada
Las comprobaciones normales fallan en los dominios catch-all. Cuando el servidor de correo de una empresa acepta cualquier dirección entrante, las herramientas normales reciben una respuesta positiva tanto para buzones reales como para errores de escritura. Como no pueden verificar más, la mayoría marca la dirección como "arriesgada" o "accept-all" y te deja la decisión.
Alrededor del 30 % de una lista B2B típica está en dominios catch-all o en dominios protegidos por gateways de seguridad (SEG) como Proofpoint y Mimecast. Si los borras, descartas compradores reales. Si envías sin verificar, los rebotes se disparan.
Nuestro motor de verificación resuelve los catch-all a fondo en la misma llamada. Comprueba si el buzón existe y devuelve catch_all_verdict ("valid" o "invalid") y catch_all_score de 0 a 100. Más información en nuestras guías sobre la verificación catch-all y sobre cómo comprobar buzones protegidos por gateways de seguridad.
API de verificación tradicional
Se rinde ante los dominios accept-all
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}La duda pasa a tu equipo. Envías y te arriesgas a muchos rebotes, o descartas compradores potenciales válidos.
API de Giggal.ai
Resuelve los catch-all en la misma llamada
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}Buzón activo confirmado. Conserva tus contactos catch-all reales y protege tu reputación de remitente.
Endpoints para comprobaciones individuales, masivas y catch-all
Tanto si compruebas un contacto como si verificas listas grandes, nuestra API para verificar correos tiene endpoints diseñados para el rendimiento y la fiabilidad.
Verificación de un correo
Verificación síncrona de una dirección de correo. Comprueba si la dirección existe, analiza el dominio y resuelve las direcciones catch-all en la misma llamada. Devuelve un resultado JSON completo.
Ver la documentación del endpointVerificación masiva de correos
Procesamiento asíncrono de hasta 50.000 direcciones por trabajo. Elimina en el servidor los duplicados y la sintaxis no válida. Admite la cabecera Idempotency-Key para evitar cobros dobles.
Consulta del trabajo y resultados
Consulta el progreso del trabajo con GET /v1/jobs/:jobId cada 10 a 15 segundos. Obtén resultados paginados de hasta 500 registros por página. Los resultados se guardan de forma segura durante 48 horas.
Resolución catch-all masiva
Aplica la resolución catch-all a fondo a las direcciones marcadas como catch-all en un trabajo masivo terminado. Descarga los resultados en un CSV limpio con columnas de puntuación y estado.
Ver la documentación catch-allIndicadores en cada respuesta
Además de válido o no válido, cada respuesta incluye atributos detallados del buzón para segmentar contactos, evitar abusos y aplicar reglas de filtrado automáticas.
| Indicador | Ruta del campo | Descripción y uso |
|---|---|---|
| Desechable | details.attributes.disposable | Identifica buzones temporales de usar y tirar. Bloquéalos de inmediato para frenar el fraude en las pruebas gratuitas. |
| Cuenta de rol | details.attributes.role_account | Detecta buzones genéricos de departamento (info@, billing@, support@). Envíalos a los equipos de CRM. |
| Correo gratuito | details.attributes.free_email | Marca los dominios de webmail de consumo (gmail.com, yahoo.com) para separar los buzones personales de los contactos de empresa. |
| Catch-all | details.attributes.catch_all | Indica si el servidor acepta todo el correo. Úsalo con catch_all_verdict para recuperar contactos válidos. |
| Alias con signo más | details.attributes.has_plus_tag | Detecta direcciones con subdirecciones de alias (user+tag@). Evita que una misma persona cree varias cuentas. |
| Buzón lleno | details.attributes.mailbox_full | Indica que se superó la cuota de almacenamiento. El correo enviado aquí tendrá un rebote suave. |
| No-reply | details.attributes.no_reply | Marca direcciones de difusión que nadie revisa. No envíes aquí mensajes de prospección que esperan respuesta. |
| Comprobación de listas negras | details.blacklist.is_blacklisted | Evalúa el dominio y las IP del servidor en las principales listas DNSBL, con puntuaciones de reputación. |
Dónde usan los equipos la API de verificación de correo
Nuestros endpoints se conectan directamente a flujos de datos, procesos de CRM y bases de datos.
Sincronización con CRM y almacén de datos
Verifica los datos de contacto de forma continua antes de sincronizarlos con Salesforce, HubSpot o Snowflake. Limpia los registros antiguos de forma programada y mantén exactos los datos de contacto.
Limpieza de listas para campañas
Depura las listas de correo antes de los grandes envíos de prospección. También puedes subir listas directamente en nuestra interfaz de limpieza de listas de correo para un trabajo manual rápido.
Flujos de enriquecimiento de leads
Lanza comprobaciones automáticas del buzón cada vez que tus herramientas de SDR inbound o de enriquecimiento outbound encuentran nuevos correos de empresa, para que los comerciales solo contacten direcciones verificadas.
Automatización de flujos de trabajo
Conecta nuestros endpoints de verificación directamente a flujos de Zapier, n8n, Make y webhooks desde nuestro centro de integraciones.
Agentes de IA con MCP
Permite que Claude, ChatGPT, Cursor y tus propios agentes de IA verifiquen contactos durante las conversaciones con nuestro servidor MCP.
Validación de formularios de registro
¿Quieres comprobar las direcciones mientras los usuarios las escriben en formularios de registro y de captación de leads? Mira nuestra API de validación de correo, hecha para comprobaciones en tiempo real en formularios.
Ejemplos de código
Fragmentos de servidor para comprobaciones individuales y masivas. Guarda tu clave de API en variables de entorno.
// Node.js (Node 18+)
const res = 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: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))Flujo masivo: enviar, consultar y obtener resultados
Enviar un trabajo por lotes requiere una sola llamada. Consulta cada 10 a 15 segundos hasta que el estado del trabajo sea completed.
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();Precios de la API de verificación de correo
Precios sencillos de pago por uso, sin permanencia mensual. Un crédito verifica una dirección. En las comprobaciones individuales por API, la resolución catch-all está incluida en el mismo crédito. En los trabajos masivos, la verificación estándar cuesta 1 crédito por dirección, y la verificación a fondo de las filas catch-all cuesta 1 crédito por cada dirección catch-all comprobada. Los créditos no caducan y los resultados desconocidos se reembolsan automáticamente.
¿Necesitas un volumen mayor para tu empresa? Consulta todos nuestros planes de precios.
Límites de uso y errores
Se aplican límites de uso estándar por clave de API. El estado del límite se devuelve en todas las solicitudes mediante cabeceras estándar:X-RateLimit-Limit yX-RateLimit-Remaining.
Límites por ventana de 15 minutos
- Comprobaciones individuales (/v1/verify)300 solicitudes / 15 min
- Creación de trabajos por lotes30 solicitudes / 15 min
- Creación de trabajos catch-all30 solicitudes / 15 min
- Consulta de trabajos y resultados600 solicitudes / 15 min
Códigos de error de estado HTTP
- 400 Bad Request: Sintaxis no válida o cuerpo JSON mal formado.
- 401 Unauthorized: Clave de API ausente, caducada o no válida.
- 402 Payment Required: Saldo de créditos insuficiente en la cuenta.
- 404 Not Found: El ID de trabajo solicitado no existe.
- 409 Conflict: Conflicto con la clave de idempotencia.
- 410 Gone: Los resultados del trabajo por lotes caducaron tras 48 horas.
- 429 Too Many Requests: Se superó el límite de uso.
Los formatos detallados de las respuestas de error y sus descripciones están en la documentación de errores de la API.
Qué dicen los clientes
Opiniones reales de equipos de desarrollo, ventas y crecimiento que usan Giggal.ai.
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
Usuario verificado de G2
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
Usuario de SourceForge
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Usuario de Product Hunt
Preguntas frecuentes sobre la API de verificación de correo
Preguntas técnicas habituales sobre autenticación, comprobación de buzones y tratamiento de los catch-all.
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 enviar solicitudes de verificación de inmediato. Los créditos gratis no caducan y dan acceso completo a todos los endpoints, incluidas la comprobación completa del buzón y la resolución catch-all a fondo.
La API comprueba si el buzón existe. Hace consultas DNS y MX, se conecta al servidor de correo de destino y comprueba si ese buzón existe y puede recibir correo. La conexión se cierra de forma limpia antes de transmitir ningún mensaje, así que el destinatario nunca recibe un correo.
En los dominios catch-all, un servidor de correo normal responde que cualquier dirección es aceptable, y por eso las herramientas habituales devuelven "arriesgado" o "desconocido". Giggal comprueba si el buzón existe y devuelve un resultado válido o no válido con un catch_all_score de 0 a 100, para que no descartes contactos reales.
El estado "desconocido" aparece cuando el servidor de correo de destino no da una respuesta clara dentro de nuestro tiempo límite, normalmente por un greylisting agresivo o por caídas temporales del servidor. Nunca pagas por respuestas no concluyentes: los créditos de cualquier verificación con estado desconocido se devuelven automáticamente al saldo de tu cuenta.
Las solicitudes de verificación individual comprueban un correo por llamada, de forma síncrona y con una respuesta JSON directa. Para verificar listas, nuestro endpoint masivo acepta hasta 50.000 direcciones de correo por trabajo, de forma asíncrona. Puedes seguir el progreso consultando el trabajo y obtener los resultados paginados cuando termina el proceso.
Sí. Giggal.ai aloja un servidor MCP (Model Context Protocol) remoto oficial en https://mcp.giggal.ai/mcp. Claude y ChatGPT se conectan al servidor alojado mediante OAuth, sin clave de API. Para flujos locales de desarrollo en Cursor, VS Code y otros clientes, puedes configurar el servidor local giggal-mcp con tu clave de API y verificar direcciones desde tu editor.
Una API de verificación de correo comprueba si un buzón existe: habla directamente con los servidores de correo de destino, revisa los registros DNS y resuelve las direcciones catch-all en listas de ventas y bases de datos de clientes. Una API de validación de correo se centra en comprobaciones en tiempo real en los formularios de registro: revisa el formato, detecta dominios desechables y bloquea cuentas falsas al enviar el formulario. Si necesitas proteger formularios, mira nuestra API de validación de correo.
Busca tres cosas: una resolución catch-all real, para no perder hasta el 30 % de tus contactos B2B en el grupo de "arriesgados"; una facturación clara que reembolse automáticamente los resultados desconocidos; y un precio claro por verificación, sin cuotas recurrentes ocultas ni mínimos mensuales.
Empieza a verificar correos en minutos
1.000 créditos gratis, sin tarjeta.
