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.

Powered by Mitrol

Quick Start

Get started in 3 simple steps:

1

Create an Account

Sign up for a free account to get your API key

2

Generate API Key

Create an API key in your dashboard

3

Start Validating

Make your first API call

Authentication

All API requests must include your API key in the Authorization header:

bash
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

POST
/api/validate/email

Request Body:

json
{
  "email": "user@example.com",
  "level": 1
}

Parameters:

email

The email address to validate

required
level

Validation level: 1 (basic) or 2 (advanced)

required

Niveles de Validación

Ofrecemos dos niveles de validación diseñados para diferentes necesidades comerciales y presupuestos.

Nivel 1 - Básico

1 Crédito
Recomendado

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

2 Créditos
Premium

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ísticaNivel 1 - BásicoNivel 2 - Avanzado
Costo por validación1 crédito2 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):

json
{
  "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

valid
boolean

Descripción: Indica si el email es válido y entregable.

Uso Comercial: Decisión principal para incluir/excluir el email de campañas.

💼 Casos de uso: Filtrado automático en formularios, segmentación de listas, validación pre-envío
reason
string

Descripción: Explicación legible del resultado de validación.

Uso Comercial: Logging, debugging, reportes para usuarios finales.

💼 Casos de uso: Mensajes de error personalizados, análisis de calidad de datos, auditorías
domain
string

Descripción: Dominio extraído del email (ej: "gmail.com").

Uso Comercial: Segmentación por proveedor, análisis de dominios corporativos vs. personales.

💼 Casos de uso: Targeting por tipo de email, análisis de audiencia, detección de patrones corporativos

Campos Técnicos

mx_exists
boolean

Descripción: Confirma si el dominio tiene registros MX configurados.

Uso Comercial: Verificación básica de infraestructura de email del dominio.

⚙️ Impacto técnico: Dominios sin MX no pueden recibir emails - filtrado automático esencial
disposable
boolean

Descripción: Identifica emails temporales o desechables (10minutemail, guerrillamail, etc.).

Uso Comercial: Prevención de registros fraudulentos, mejora de calidad de leads.

🛡️ Protección: Evita usuarios temporales, mejora métricas de engagement, reduce spam
deliverability_score
number (0-100)
Solo Nivel 2

Descripció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.

📊 Rangos recomendados: >90 (excelente), 70-90 (bueno), 50-70 (regular), <50 (evitar)

Metadatos Avanzados (additional_info)
Solo Nivel 2

webmail
boolean

Descripción: Indica si es un proveedor de webmail (Gmail, Yahoo, Outlook, etc.).

Uso Comercial: Diferenciación entre emails corporativos y personales.

🎯 Estrategia: Emails corporativos (false) = leads B2B, webmail (true) = audiencia B2C
catch_all
boolean

Descripción: Dominio configurado para aceptar emails a cualquier dirección.

Uso Comercial: Identificación de configuraciones que pueden generar falsos positivos.

⚠️ Consideración: Catch-all = mayor riesgo de bounces, usar con precaución en campañas críticas
role_based
boolean

Descripción: Email de rol genérico (info@, support@, admin@, etc.).

Uso Comercial: Identificación de contactos no personalizados, compliance con regulaciones.

📋 Compliance: Algunos países/regulaciones requieren evitar emails role-based para marketing
free_provider
boolean

Descripción: Proveedor gratuito de email (Gmail, Yahoo, Hotmail, etc.).

Uso Comercial: Segmentación por tipo de usuario, estrategias de pricing diferenciadas.

💰 Insight comercial: Free providers = usuarios individuales, paid domains = empresas

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

400

Bad Request

Invalid request format or missing parameters

401

Unauthorized

Invalid or missing API key

429

Too Many Requests

Rate limit exceeded

402

Payment Required

Insufficient credits

Code Examples

JavaScript / Node.js

javascript
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

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
<?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