La API REST del email temporal
Integra el email desechable, la bandeja temporal y la detección de OTP en tus apps con unas pocas líneas. REST sencillo, JSON limpio, CORS abierto, sin autenticación.
Pruébalo directamente desde tu navegador
No necesitas Postman ni un terminal. Elige un endpoint, ajusta los parámetros y ejecuta. La respuesta real de la API aparece en directo.
Pulsa «Ejecutar» para lanzar la petición…
Pulsa «Ejecutar» para lanzar la petición…
Pulsa «Ejecutar» para lanzar la petición…
Sin parámetros. Devuelve la lista de dominios de email activos.
Pulsa «Ejecutar» para lanzar la petición…
Endpoints
Todos los endpoints usan HTTPS, devuelven JSON UTF-8 e incluyen las cabeceras X-RateLimit-* para que sigas tu consumo.
Copia y pega en tu stack
Flujo completo: crear una bandeja → consultar los emails → extraer el código OTP. En el lenguaje que prefieras.
Límites de tasa
La API pública es gratuita y limitada por IP. Las cuentas Premium multiplican estos límites (×2–10) y tienen una cuota por cuenta con su clave API.
- Crear una bandeja, 5/min · 50/h
- Leer mensajes, 10/min · 50/h
- Dominios, 10/min
- Cuota por cuenta (no compartida por IP)
Límites por plan
| Oferta | Crear una bandeja | Leer mensajes | Dominios |
|---|---|---|---|
| Gratis (por IP) | 5/min · 50/h | 10/min · 50/h | 10/min |
| Mensual ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Anual ×2 | 10/min · 100/h | 20/min · 100/h | 20/min |
| Mensual API+ ×10 | 50/min · 500/h | 100/min · 500/h | 100/min |
Hazte Premium para multiplicar tus límites.
Lo que los devs construyen con esto
Usos concretos de la API de mail123, de los tests e2e a la automatización de marketing. Todos legítimos, todos sin registro.
Tests e2e automatizados
Playwright, Cypress, Selenium: genera una dirección al vuelo, rellena el formulario, lee el email de confirmación y extrae el enlace o el código. Ciclo completo en 30 segundos.
Saltarse la verificación de email
Regístrate en servicios dudosos, crea cuentas desechables para probar una demo o accede una sola vez a contenido que pide email, sin ensuciar tu bandeja principal.
Bots y automatización
Scrapers que deben superar una confirmación por email, flujos de n8n/Make/Zapier, scripts de Selenium que automatizan el onboarding. La API se integra con 3 líneas.
Entornos de desarrollo
Entornos de staging y preview: sustituye Mailtrap, MailHog o SES por una API pública. El equipo ve emails reales sin configurar SMTP.
Tutoriales y formación
Demos de webhooks, ejercicios de OAuth, formación en seguridad: una dirección pública desechable permite practicar sin arriesgar la bandeja real.
Herramientas de privacidad
Extensiones de navegador, gestores de contraseñas, herramientas antispam: integra la generación de alias en una sola llamada HTTP.
Códigos HTTP y gestión de errores
Todas las respuestas incluyen un campo success: bool y un campo opcional error: string. Los códigos HTTP siguen las convenciones REST.
| Code | Significado | Acción |
|---|---|---|
| 200 | Success | La respuesta incluye success: true |
| 400 | Bad Request | Revisa la sintaxis de la dirección o del parámetro |
| 403 | Forbidden | Dirección reservada (admin, root, postmaster…) |
| 404 | Not Found | Email no encontrado o caducado |
| 429 | Too Many Requests | Espera 1 minuto o reintenta tras el restablecimiento |
| 500 | Server Error | Error del servidor: reintenta y, si persiste, contacta con soporte |
Preguntas frecuentes
Respuestas a las preguntas que más nos hacen los desarrolladores.
¿La API es realmente gratuita?
¿Necesito una clave API?
¿La API admite CORS?
¿Cuánto tiempo se conservan los emails?
¿La API detecta los códigos OTP automáticamente?
¿Qué dominios de email hay disponibles?
mail123.frmail456.frmail789.frmail1mail.commail123.clickmail123.com.brmail123.beermail123box.techmail123.promail123.sitemail123.onlinemail123.techmail123.website. Lista en vivo con GET /api/v1/domains.¿La API admite webhooks?
¿Qué pasa si alcanzo el límite de peticiones?
¿Qué usos están permitidos?
¿El servicio es fiable? ¿Qué disponibilidad tiene?
Construye algo genial
Sin registro. Sin tarjeta. Sin configurar webhooks. Haz tu primera llamada a la API en 10 segundos.