API Documentation
Documentación completa para la API de validación de emails de Mitrol. Aprenda a integrar y usar nuestros endpoints de manera eficiente.
Quick Start
Get started in 3 simple steps:
Create an Account
Sign up for a free account to get your API key
Generate API Key
Create an API key in your dashboard
Start Validating
Make your first API call
Authentication
All API requests must include your API key in the Authorization header:
curl -X POST https://email-validator.mitrolsolutions.dev/api/validate/email \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"test@example.com","level":1}'Endpoints
Email Validation
Validate email addresses with different levels of verification
/api/validate/emailRequest Body:
{
"email": "user@example.com",
"level": 1
}Parameters:
emailThe email address to validate
levelValidation level: 1 (basic) or 2 (advanced)
Niveles de Validación
Ofrecemos dos niveles de validación diseñados para diferentes necesidades comerciales y presupuestos.
Nivel 1 - Básico
Perfecto para la mayoría de casos de uso. Proporciona validación rápida y confiable con verificaciones esenciales para mantener listas de correo limpias.
Verificaciones Incluidas:
Validación de Sintaxis
Verifica formato RFC compliant (usuario@dominio.com)
Registros MX
Confirma que el dominio puede recibir emails
Detección de Emails Desechables
Identifica servicios temporales (10minutemail, etc.)
Procesamiento Rápido
Respuesta típica < 200ms
Casos de Uso Ideales:
- • Validación en formularios de registro
- • Limpieza masiva de listas existentes
- • Verificación antes de campañas de marketing
- • Integración en sistemas CRM
- • Aplicaciones con alto volumen
💡 Tip: Ideal para reducir rebotes y mejorar deliverability básica
Nivel 2 - Avanzado
Validación exhaustiva para campañas críticas. Incluye verificación profunda de buzones y análisis de entregabilidad para máxima precisión.
Verificaciones Incluidas:
Todas las verificaciones básicas
Sintaxis, MX records, emails desechables
Verificación Profunda de Buzón
Confirma existencia real del buzón de correo
Puntuación de Entregabilidad
Score 0-100 basado en múltiples factores
Metadatos Avanzados
Tipo de proveedor, catch-all, role-based
Casos de Uso Ideales:
- • Campañas de email marketing críticas
- • Leads de alta conversión
- • Listas premium de clientes
- • Verificación pre-transaccional
- • Compliance y auditorías
🎯 Tip: Maximiza ROI en campañas premium y reduce riesgo de blacklisting
Comparación Rápida
| Característica | Nivel 1 - Básico | Nivel 2 - Avanzado |
|---|---|---|
| Costo por validación | 1 crédito | 2 créditos |
| Tiempo de respuesta | < 200ms | < 500ms |
| Precisión estimada | ~95% | ~99% |
| Verificación de buzón | ❌ | ✅ |
| Score de entregabilidad | ❌ | ✅ |
Formato de Respuesta
Cada validación retorna un objeto JSON con información detallada sobre el email analizado.
Ejemplo de Respuesta Exitosa (200 OK):
{
"valid": true,
"reason": "Valid email address",
"domain": "example.com",
"mx_exists": true,
"disposable": false,
"deliverability_score": 95,
"additional_info": {
"webmail": true,
"catch_all": false,
"role_based": false,
"free_provider": true
}
}Explicación Detallada de Campos
Campos Principales
validDescripción: Indica si el email es válido y entregable.
Uso Comercial: Decisión principal para incluir/excluir el email de campañas.
reasonDescripción: Explicación legible del resultado de validación.
Uso Comercial: Logging, debugging, reportes para usuarios finales.
domainDescripción: Dominio extraído del email (ej: "gmail.com").
Uso Comercial: Segmentación por proveedor, análisis de dominios corporativos vs. personales.
Campos Técnicos
mx_existsDescripción: Confirma si el dominio tiene registros MX configurados.
Uso Comercial: Verificación básica de infraestructura de email del dominio.
disposableDescripción: Identifica emails temporales o desechables (10minutemail, guerrillamail, etc.).
Uso Comercial: Prevención de registros fraudulentos, mejora de calidad de leads.
deliverability_scoreDescripción: Puntuación de 0-100 que indica la probabilidad de entrega exitosa.
Uso Comercial: Priorización de contactos, optimización de campañas, segmentación por calidad.
Metadatos Avanzados (additional_info)Solo Nivel 2
webmailDescripción: Indica si es un proveedor de webmail (Gmail, Yahoo, Outlook, etc.).
Uso Comercial: Diferenciación entre emails corporativos y personales.
catch_allDescripción: Dominio configurado para aceptar emails a cualquier dirección.
Uso Comercial: Identificación de configuraciones que pueden generar falsos positivos.
role_basedDescripción: Email de rol genérico (info@, support@, admin@, etc.).
Uso Comercial: Identificación de contactos no personalizados, compliance con regulaciones.
free_providerDescripción: Proveedor gratuito de email (Gmail, Yahoo, Hotmail, etc.).
Uso Comercial: Segmentación por tipo de usuario, estrategias de pricing diferenciadas.
Inteligencia Comercial
Segmentación Automática
- • B2B Premium: valid=true + webmail=false + free_provider=false
- • B2C Confiable: valid=true + deliverability_score>80
- • Leads Corporativos: domain corporativo + role_based=false
- • Audiencia Riesgo: catch_all=true OR disposable=true
KPIs y Métricas
- • Tasa de Validez: % emails con valid=true
- • Score Promedio: Promedio de deliverability_score
- • Ratio B2B/B2C: % free_provider=false
- • Calidad de Lista: % disposable=false + score>70
Error Codes
Bad Request
Invalid request format or missing parameters
Unauthorized
Invalid or missing API key
Too Many Requests
Rate limit exceeded
Payment Required
Insufficient credits
Code Examples
JavaScript / Node.js
const response = await fetch('https://email-validator.mitrolsolutions.dev/api/validate/email', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'user@example.com',
level: 1
})
});
const result = await response.json();
console.log(result);Python
import requests
url = 'https://email-validator.mitrolsolutions.dev/api/validate/email'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
data = {
'email': 'user@example.com',
'level': 1
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)PHP
<?php
$url = 'https://email-validator.mitrolsolutions.dev/api/validate/email';
$data = json_encode([
'email' => 'user@example.com',
'level' => 1
]);
$context = stream_context_create([
'http' => [
'method' => 'POST',
'header' => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json'
],
'content' => $data
]
]);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);
print_r($response);
?>Rate Limits
Basic Plan
100 requests per minute
Pro Plan
1000 requests per minute
Support
Need Help?
Our team is here to help you integrate successfully.
📧 Email: support@mitrolsolutions.dev
🌐 Website: mitrol.net
