Documentación para Desarrolladores

Referencia de la API de EvilMail

Integra correo desechable, dominios personalizados, lectura de bandeja de entrada, gestión DNS y extracción inteligente de códigos de verificación en tus aplicaciones.

URL Base:https://evilmail.pro

Formato:JSON

Autenticación:Clave API / Sesión

Protocolos:Solo HTTPS

Descripción General

La API de EvilMail proporciona acceso programático a todas las funciones de la plataforma. Crea correos desechables, administra dominios personalizados, lee bandejas de entrada, extrae códigos de verificación y controla registros DNS, todo a través de una interfaz RESTful simple.

API de Correo Temporal

Crea bandejas desechables, lee mensajes, autoexpiración

API de Dominio y Correo

Dominios personalizados, cuentas de correo, gestión DNS

Extracción Regex

Extracción automática de códigos de verificación de más de 8 servicios

Formato de Respuesta

Todas las respuestas siguen una estructura JSON consistente:

{
  "status": "success" | "error",
  "message": "Human-readable message (optional)",
  "messageKey": "i18n key for localized errors (optional)",
  "data": { ... }
}

Las respuestas de error incluyen messageKey para mensajes de error localizados según el idioma de la cuenta del usuario.

Autenticación

EvilMail usa dos métodos de autenticación según el tipo de endpoint. Todas las solicitudes API deben realizarse sobre HTTPS.

Clave API

Para creación de correo temporal y extracción de códigos de verificación. Requiere una suscripción de pago activa.

X-API-Key: your_64char_hex_key

Cookie de Sesión

Para endpoints de gestión de dominios, cuentas de correo y DNS. Se establece después del inicio de sesión.

Cookie: evilmail_session=...

La API de Correo Temporal requiere un plan de pago

Los endpoints de la API de correo temporal y extracción regex requieren una suscripción activa de Bronze, Gold o Premium. Las cuentas gratuitas solo pueden usar la interfaz web.

Correo Temporal

Plan de Pago Requerido

Crea direcciones de correo desechables con TTL configurable. Dominios disponibles: evilmail.pro, evilmail.cloud.

Create a temporary email address

Cuerpo de la Solicitud

domainstringopcionalDomain to use (default: evilmail.pro)

ttlMinutesnumberopcionalLifetime: 10, 30, 60, 360, 1440 (default: 60)

Respuesta

{
  "status": "success",
  "data": {
    "email": "[email protected]",
    "domain": "evilmail.pro",
    "sessionToken": "a1b2c3d4...",
    "ttlMinutes": 60,
    "expiresAt": "2026-03-07T15:30:00.000Z"
  }
}

Available domains: evilmail.pro, evilmail.cloud. Requires an active paid subscription.

Bandeja y Mensajes

Lee correos entrantes de tu bandeja temporal. Los mensajes se obtienen vía IMAP y se devuelven en tiempo real.

Gestión de Dominios

Registra dominios personalizados, verifica DNS y administra tu infraestructura de correo. Los límites de dominios dependen de tu plan.

Cuentas de Correo

Crea, lista y administra cuentas de correo bajo tus dominios verificados. Soporta creación individual y por lotes con generación de nombres de usuario aleatorios.

Extracción Inteligente de Códigos de Verificación

Clave API

Extrae automáticamente códigos de verificación de correos entrantes. Perfecto para pruebas automatizadas, flujos de registro de cuentas y pipelines CI/CD.

Extract verification code from the latest email

Parámetros

servicestringobligatorioService name (see supported list)

emailstringobligatorioEmail address to search (query param)

Respuesta

{
  "status": "success",
  "data": {
    "code": "847291",
    "service": "google",
    "email": "[email protected]",
    "from": "[email protected]",
    "subject": "Your verification code",
    "date": "2026-03-07T14:22:00.000Z"
  }
}

Searches the last 20 messages. You must own the domain.

Servicios Soportados

Servicio	Endpoint	Patrón de Código	Dominios del Remitente
Google	/api/regex/google	G-XXXXXX	google.com, accounts.google.com
Facebook	/api/regex/facebook	XXXXXX	facebookmail.com, facebook.com
Twitter/X	/api/regex/twitter	XXXXXXXX	twitter.com, x.com
Instagram	/api/regex/instagram	XXXXXX	instagram.com, mail.instagram.com
TikTok	/api/regex/tiktok	XXXX-XXXXXX	tiktok.com
Discord	/api/regex/discord	XXXXXX	discord.com
LinkedIn	/api/regex/linkedin	XXXXXX	linkedin.com
iCloud	/api/regex/icloud	XXXXXX	apple.com, id.apple.com

¿Necesitas un Servicio Diferente?

Si el servicio que buscas no aparece en la lista anterior, haznos saber. Expandimos regularmente nuestras integraciones soportadas basándonos en comentarios de desarrolladores y podemos agregar nuevos patrones regex para cualquier servicio de verificación por correo.

Contáctanos

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

Gestión DNS

Gestión completa de registros DNS vía PowerDNS. Soporta tipos de registro A, AAAA, CNAME, MX, TXT, NS, SRV y CAA. Los registros se propagan a través de 4 servidores de nombres distribuidos geográficamente.

Ejemplos de Código

Ejemplos funcionales completos para crear correos temporales, leer bandejas de entrada y extraer códigos de verificación.

Flujo de Correo Temporal

api-example

# Create a temporary email
curl -X POST https://evilmail.pro/api/temp-email \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"domain": "evilmail.pro", "ttlMinutes": 60}'

# Response: { "data": { "email": "...", "sessionToken": "abc123..." } }

# Poll for incoming messages using the session token
curl https://evilmail.pro/api/temp-email/abc123...

# Response includes messages array
# { "data": { "email": "...", "messages": [...] } }

Extracción de Códigos de Verificación

api-example

# Extract Google verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract Discord verification code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

# Extract TikTok code
curl "https://evilmail.pro/api/regex/[email protected]" \
  -H "X-API-Key: YOUR_API_KEY"

Ejemplos de Gestión de Dominios

api-example

# Add a domain
curl -X POST https://evilmail.pro/api/domains \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# List domains
curl https://evilmail.pro/api/domains \
  -H "Cookie: evilmail_session=YOUR_SESSION"

# Verify DNS
curl -X POST https://evilmail.pro/api/domains/check \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"domain": "mydomain.com"}'

# Create email account
curl -X POST https://evilmail.pro/api/accounts \
  -H "Content-Type: application/json" \
  -H "Cookie: evilmail_session=YOUR_SESSION" \
  -d '{"email": "[email protected]", "password": "secure123"}'

Límites de Frecuencia y Planes

Límites del Plan

Función	Free	Bronze	Gold	Premium
Dominios Personalizados	1	5	25	999
Correos / Dominio	5	999	999	999
API de Correo Temporal	Solo web	Completo	Completo	Completo
Regex API	Solo web	Completo	Completo	Completo
Límite de Frecuencia API	100/hr	1,000/hr	5,000/hr	Ilimitado
Sesiones Temporales / IP	10	10	10	10

Límites de Frecuencia por Endpoint

Por dirección IP

POST /api/auth/login10 / 15 min

POST /api/auth/register5 / 1 hour

POST /api/auth/forgot-password3 / 1 hour

POST /api/auth/reset-password5 / 15 min

PUT /api/account/password5 / 15 min

POST /api/contact5 / 1 hour

POST /api/temp-email10 sessions / IP

GET /api/regex/{service}Basado en el plan

Manejo de Errores

Todas las respuestas de error incluyen un campo status establecido en "error", un mensaje legible y un messageKey opcional para mensajes de error localizados según el idioma de la cuenta del usuario.

{
  "status": "error",
  "message": "Domain limit reached. Upgrade your plan for more.",
  "messageKey": "domainLimitReached"
}

Código	Estado	Descripción
200	Success	Request completed successfully
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing authentication
403	Forbidden	Insufficient permissions or plan limits
404	Not Found	Resource does not exist
409	Conflict	Resource already exists (duplicate)
429	Rate Limited	Too many requests, slow down
500	Server Error	Internal server error

Mensajes de Error Localizados

Usa el campo messageKey para mostrar errores en el idioma preferido del usuario. Soportados: inglés, turco, ruso, ucraniano, polaco, francés, alemán, azerbaiyano, persa, filipino, hausa, akan.

Explorador API

Prueba los endpoints de la API directamente desde tu navegador. Ingresa tu clave API y envía solicitudes para ver respuestas en vivo.

Explorador APIv1.0

evilmail.pro

POST

POSThttps://evilmail.pro/api/temp-email

Clave API

Cuerpo de la Solicitud

domain

ttlMinutes

Envía una solicitud para ver la respuesta

¿Listo para integrar?

Obtén tu clave API desde el panel y comienza a construir. Acceso completo con cualquier plan de pago.

Comenzar Gratis Ver Planes

{ "status": "success", "data": { "email": "[email protected]", "domain": "evilmail.pro", "sessionToken": "a1b2c3d4...", "ttlMinutes": 60, "expiresAt": "2026-03-07T15:30:00.000Z" } }

{ "status": "success", "data": { "code": "847291", "service": "google", "email": "[email protected]", "from": "[email protected]", "subject": "Your verification code", "date": "2026-03-07T14:22:00.000Z" } }

Servicio

Endpoint

Patrón de Código

Dominios del Remitente

Google

/api/regex/google

G-XXXXXX

google.com, accounts.google.com

Facebook

/api/regex/facebook

XXXXXX

facebookmail.com, facebook.com

Twitter/X

/api/regex/twitter

XXXXXXXX

twitter.com, x.com

Instagram

/api/regex/instagram

XXXXXX

instagram.com, mail.instagram.com

TikTok

/api/regex/tiktok

XXXX-XXXXXX

tiktok.com

Discord

/api/regex/discord

XXXXXX

discord.com

/api/regex/linkedin

XXXXXX

linkedin.com

iCloud

/api/regex/icloud

XXXXXX

apple.com, id.apple.com

# Extract Google verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract Discord verification code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY" # Extract TikTok code curl "https://evilmail.pro/api/regex/[email protected]" \ -H "X-API-Key: YOUR_API_KEY"

# Create a temporary email curl -X POST https://evilmail.pro/api/temp-email \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{"domain": "evilmail.pro", "ttlMinutes": 60}' # Response: { "data": { "email": "...", "sessionToken": "abc123..." } } # Poll for incoming messages using the session token curl https://evilmail.pro/api/temp-email/abc123... # Response includes messages array # { "data": { "email": "...", "messages": [...] } }

# Add a domain curl -X POST https://evilmail.pro/api/domains \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # List domains curl https://evilmail.pro/api/domains \ -H "Cookie: evilmail_session=YOUR_SESSION" # Verify DNS curl -X POST https://evilmail.pro/api/domains/check \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"domain": "mydomain.com"}' # Create email account curl -X POST https://evilmail.pro/api/accounts \ -H "Content-Type: application/json" \ -H "Cookie: evilmail_session=YOUR_SESSION" \ -d '{"email": "[email protected]", "password": "secure123"}'

Función

Free

Bronze

Gold

Premium

Dominios Personalizados

999

Correos / Dominio

999

API de Correo Temporal

Solo web

Completo

Regex API

Solo web

Completo

Límite de Frecuencia API

100/hr

1,000/hr

5,000/hr

Ilimitado

Sesiones Temporales / IP

Código

Estado

Descripción

200

Success

Request completed successfully

400

Bad Request

Missing or invalid parameters

401

Unauthorized

Invalid or missing authentication

403

Forbidden

Insufficient permissions or plan limits

404

Not Found

Resource does not exist

409

Conflict

Resource already exists (duplicate)

429

Rate Limited

Too many requests, slow down

500

Server Error

Internal server error