Limites
Tudo que é limitado, em um só lugar. Publicado em vez de descoberto — um limite que você encontra de surpresa é um bug na documentação.
Em resumo
1–5/seg
Requisições de API, por endereço
Uma sem chave; 2, 3 ou 5 com uma chave de um plano pago. Fazer polling uma vez por segundo é o padrão pretendido.
60/min
Requisições de API grátis, por minuto
Por endereço IP, sem chave. Os planos pagos não têm limite por minuto.
1.000/dia
Requisições de API grátis, por dia
Por endereço IP, zera às 00:00 UTC. Os planos pagos não têm limite diário.
5dias
Retenção de mensagens
A partir da chegada, lida ou não. Limite rígido.
5MB
Tamanho máximo da mensagem
Recusado no momento do SMTP, para que o remetente seja avisado.
∞
Endereços por domínio
Nada é criado antecipadamente, então nada é contado.
200
Mensagens retornadas por chamada
Padrão de 50. Isso limita uma resposta, não a caixa de entrada:
nextpercorre o restante, seja qual for a quantidade.0
Mensagens de saída
Não há endpoint de envio. De propósito.
Limites de taxa
Grátis, sem chave: 60 requisições por minuto e 1.000 por dia, por endereço IP. Toda chamada a uma caixa de entrada conta — listá-la, ler uma mensagem, o corpo HTML dela, um anexo, uma exclusão — e o mesmo vale para cada chamada de ferramenta MCP. O contador diário zera às 00:00 UTC.
Dentro disso, uma leitura por segundo por endereço: consultar uma caixa de entrada uma vez por segundo é o ritmo previsto.
Com uma chave de API gratuita, a mesma quota acompanha a sua conta em vez do seu endereço IP — útil quando as suas chamadas saem de endereços que mudam, como um runner de CI. Uma conta gratuita tem uma chave, e as caixas que ela lê são listadas nas suas caixas. Criar uma chave gratuita
Os planos pagos não têm limite por minuto nem limite diário. Envie a chave de um plano pago como Authorization: Bearer e passa a valer só a taxa por endereço do plano — 2, 3 ou 5 requisições por segundo, em qualquer domínio, contadas por conta. O Premium custa a partir de $12,99 por mês. Ver os planos
A caixa de entrada deste site não consome a cota gratuita da API: uma página deixada aberta continua verificando se chegou e-mail pelo tempo que você precisar.
Ao passar de um limite você recebe 429 com um cabeçalho Retry-After em segundos inteiros: rate_limited para o limite por minuto ou por endereço, daily_limit_reached para o limite diário, com o tempo que falta até a meia-noite UTC. Toda resposta gratuita mostra em que pé você está: X-RateLimit-Remaining para o minuto, X-RateLimit-Daily-Remaining para o dia.
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", … }
}Use um recuo baseado em Retry-After em vez de uma espera fixa. Se o limite mudar algum dia, o código que lê o cabeçalho continua funcionando.
Tamanho da mensagem
Mensagens de até 5 MB, anexos incluídos. Esse limite é aplicado pelo servidor de e-mail durante a conversa SMTP, o que importa: o servidor remetente é avisado no momento em que tenta enviar e recebe uma falha real, em vez de a mensagem simplesmente desaparecer.
- O que conta
- A mensagem codificada inteira — cabeçalhos, corpo e todos os anexos, depois da codificação MIME. O base64 aumenta um binário em cerca de um terço, então um arquivo de aproximadamente 3,5 MB já preenche o limite.
- O que acontece na linha
- Um
552no momento do SMTP. A mensagem nunca é armazenada e nunca aparece na caixa de entrada. - Anexos por mensagem
- Vinte. Na prática, o limite de tamanho chega primeiro — mas uma mensagem com mais de vinte partes com nome de arquivo mantém as vinte primeiras.
Retenção
Uma mensagem é excluída 5 dias depois de chegar, tenha sido lida ou não, e o contador começa na entrega, não na primeira leitura.
Toda mensagem traz expires_at, então um cliente nunca precisa calcular essa data nem acompanhar a política.
É um limite rígido, não uma configuração: nenhum parâmetro, plano ou conta o estende. Se algo precisa sobreviver à janela, busque e armazene do seu lado.
Endereços e domínios
- Endereços por domínio
- Ilimitado, e não contado. Como uma caixa de entrada nunca é criada, não há lista delas para crescer.
- Regras da parte local
- De um a 64 caracteres: letras, números, ponto, hífen, sublinhado e mais. Precisa começar e terminar com letra ou número. Qualquer outra coisa é rejeitada antes de chegar ao servidor de e-mail, no navegador e novamente no servidor.
- Endereçamento com sinal de mais
name+tag@domainé uma caixa de entrada distinta aqui, não um apelido dename@domain. Isso é proposital — tags são como as pessoas separam cadastros, e uni-las juntaria caixas que deveriam ficar separadas.- Maiúsculas/minúsculas
- Tudo é convertido para minúsculas.
Name@ename@são a mesma caixa de entrada. - Domínios personalizados
- Sem limite de quantos domínios você aponta para cá. Cada um precisa do seu próprio registro MX.
Uso justo
Não há cota para comprar e ultrapassar, nem plano que aumente esses números. O que existe em vez disso: se uma única origem piora o serviço para todo mundo, ela é bloqueada.
- Consulta em massa
- Milhares de caixas de entrada consultadas por segundo a partir de uma única origem serão limitadas na borda antes de chegar à API.
- Enxurradas de email
- Um host de envio que abre um número irrazoável de conexões SMTP fica bloqueado por dez minutos. Remetentes normais nunca chegam perto disso.
- Usando-nos como relay
- Impossível em vez de proibido: o servidor de email só aceita mensagens endereçadas a domínios hospedados aqui, então ele não consegue encaminhar nada para lugar nenhum.
Nada disso é pensado para automação comum. Consultar uma vez por segundo, o dia todo, em milhares de caixas de entrada — esse é o uso pretendido, não o seu limite.