Límites
Todo lo que tiene un límite, en un solo lugar. Publicado en vez de descubierto — un límite con el que te topas por sorpresa es un fallo de la documentación.
De un vistazo
1–5/seg
Solicitudes a la API, por dirección
Una sin clave; 2, 3 o 5 con una clave de un plan de pago. Consultar una vez por segundo es el patrón previsto.
60/min
Solicitudes gratuitas a la API, por minuto
Por dirección IP, sin clave. Los planes de pago no tienen tope por minuto.
1.000/día
Solicitudes gratuitas a la API, por día
Por dirección IP, con reinicio a las 00:00 UTC. Los planes de pago no tienen tope diario.
5días
Retención de mensajes
Desde la llegada, leído o no. Límite fijo.
5MB
Tamaño máximo de mensaje
Se rechaza en el momento SMTP, así que se informa al remitente.
∞
Direcciones por dominio
No se crea nada por adelantado, así que no se cuenta nada.
200
Mensajes devueltos por llamada
50 por defecto. Esto limita una respuesta, no la bandeja:
nextrecorre el resto, sea cual sea la cantidad.0
Mensajes salientes
No hay endpoint de envío. Por diseño.
Límites de solicitudes
Gratis, sin clave: 60 solicitudes por minuto y 1.000 al día, por dirección IP. Cada llamada sobre un buzón cuenta — listarlo, leer un mensaje, su cuerpo HTML o un adjunto, borrar uno — y también cada llamada a una herramienta MCP. El contador diario se reinicia a las 00:00 UTC.
Dentro de ese margen, una lectura por segundo por dirección: consultar un buzón una vez por segundo es el ritmo previsto.
Con una clave de API gratuita, la misma cuota sigue a tu cuenta en lugar de a tu dirección IP — útil cuando tus llamadas salen de direcciones que cambian, como un runner de CI. Una cuenta gratuita tiene una clave, y los buzones que lee se listan en tus buzones. Crear una clave gratuita
Los planes de pago no tienen tope por minuto ni tope diario. Envía la clave de un plan de pago como Authorization: Bearer y solo queda el límite por dirección de tu plan — 2, 3 o 5 solicitudes por segundo, en todos los dominios, contadas por cuenta. El plan Premium empieza en $12,99 al mes. Ver los planes
La bandeja de entrada de este sitio no consume la cuota gratuita de la API: una página que dejas abierta sigue comprobando si llega correo todo el tiempo que la necesites.
Por encima de un límite recibes 429 con una cabecera Retry-After en segundos enteros: rate_limited para el límite por minuto o por dirección, daily_limit_reached para el límite diario, con el tiempo que queda hasta la medianoche UTC. En el acceso gratuito, cada respuesta te indica cuánto te queda: X-RateLimit-Remaining para el minuto, X-RateLimit-Daily-Remaining para el día.
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 0
Content-Type: application/json
{
"error": "daily_limit_reached",
"message": "free daily limit reached: 1000 requests a day per IP address, resets at 00:00 UTC — paid plans have no daily cap",
"upgrade": { "from": "$12.99/month", "url": "https://grabmail.io/pricing", … }
}Espera según Retry-After en lugar de una pausa fija. Si el límite cambia alguna vez, el código que lee el encabezado sigue funcionando.
Tamaño del mensaje
Mensajes de hasta 5 MB, adjuntos incluidos. Ese límite lo aplica el servidor de correo durante la conversación SMTP, lo cual importa: al servidor emisor se le informa en el momento en que lo intenta y recibe un fallo real, en lugar de que el mensaje desaparezca sin más.
- Qué cuenta
- El mensaje codificado completo: encabezados, cuerpo y cada adjunto después de la codificación MIME. Base64 infla un binario en cerca de un tercio, así que un archivo de unos 3,5 MB ya alcanza el límite.
- Qué ocurre en la línea
- Un
552en el momento SMTP. El mensaje nunca se almacena ni aparece en el buzón. - Archivos adjuntos por mensaje
- Veinte. En la práctica, el límite de tamaño es lo primero que se encuentra, pero un mensaje con más de veinte partes con nombre de archivo conserva las primeras veinte.
Retención
Un mensaje se elimina 5 días después de llegar, se haya leído o no, y el conteo empieza en la entrega, no en la primera lectura.
Cada mensaje lleva expires_at, así que un cliente nunca tiene que calcular esa fecha ni llevar la cuenta de la política.
Es un límite fijo, no un ajuste: ningún parámetro, plan o cuenta lo amplía. Si algo debe sobrevivir a esa ventana, obtenlo y guárdalo por tu cuenta.
Direcciones y dominios
- Direcciones por dominio
- Ilimitado, y no se cuenta. Como un buzón nunca se crea, no hay ninguna lista de ellos que crezca.
- Reglas de la parte local
- De 1 a 64 caracteres: letras, dígitos, punto, guion, guion bajo y más. Debe empezar y terminar con una letra o un dígito. Cualquier otra cosa se rechaza antes de llegar al servidor de correo, en el navegador y de nuevo en el servidor.
- Direccionamiento con signo más
name+tag@domaines un buzón distinto aquí, no un alias dename@domain. Es intencionado: las etiquetas son la forma de separar registros, y unirlas fusionaría buzones que debían permanecer separados.- Mayúsculas y minúsculas
- Todo se convierte a minúsculas.
Name@yname@son la misma bandeja. - Dominios personalizados
- Sin límite de cuántos apuntes aquí. Cada uno necesita su propio registro MX.
Uso razonable
No hay una cuota que puedas comprar para superar, ni un plan que eleve estos números. Lo que sí hay: si una sola fuente empeora el servicio para todos los demás, se detiene.
- Consultas en bloque
- Miles de buzones consultados cada segundo desde una sola fuente se limitarán en el borde antes de llegar a la API.
- Avalanchas de correo
- Un host emisor que abre un número desmedido de conexiones SMTP queda bloqueado durante diez minutos. Los remitentes normales nunca se acercan a ese límite.
- Usarnos como relé
- Imposible, no solo prohibido: el servidor de correo solo acepta mensajes dirigidos a dominios alojados aquí, así que no puede reenviar nada a ningún sitio.
Nada de esto está pensado para una automatización cualquiera. Sondear una vez por segundo, todo el día, en miles de buzones — ese es el uso previsto, no su límite.