Limites

En un coup d'œil

• 1–5/sec

  Requêtes API, par adresse

  Une sans clé ; 2, 3 ou 5 avec une clé provenant d'un plan payant. Interroger une fois par seconde est le comportement prévu.

• 60/min

  Requêtes API gratuites, par minute

  Par adresse IP, sans clé. Les plans payants n'ont aucun plafond par minute.

• 1 000/jour

  Requêtes API gratuites, par jour

  Par adresse IP, remise à zéro à 00:00 UTC. Les plans payants n'ont aucun plafond quotidien.

• 5jours

  Conservation des messages

  Dès l'arrivée, lu ou non. Limite stricte.

• 5MB

  Taille maximale des messages

  Refusé au moment du SMTP, donc l'expéditeur en est informé.

• ∞

  Adresses par domaine

  Rien n'est créé à l'avance, donc rien n'est comptabilisé.

• 200

  Messages renvoyés par appel

  50 par défaut. Cela limite une réponse, pas la boîte de réception : next permet de parcourir le reste, quel qu'en soit le nombre.

• 0

  Messages sortants

  Il n’y a pas de point de terminaison d’envoi. C’est voulu.

Limites de débit

Gratuit, sans clé : 60 requêtes par minute et 1 000 par jour, par adresse IP. Chaque appel sur une boîte compte — la lister, lire un message, son corps HTML ou une pièce jointe, en supprimer un — tout comme chaque appel d'outil MCP. Le décompte quotidien repart de zéro à 00:00 UTC.

Dans ce cadre, une lecture par seconde et par adresse : interroger une boîte une fois par seconde est le rythme prévu.

Avec une clé d'API gratuite, le même quota suit votre compte et non votre adresse IP — pratique quand vos appels partent d'adresses changeantes, comme un exécuteur de CI. Un compte gratuit a une clé, et les boîtes qu'elle lit sont listées dans vos boîtes. Créer une clé gratuite

Les plans payants n'ont ni plafond par minute ni plafond quotidien. Envoyez la clé d'un plan payant en Authorization: Bearer et il ne reste que le débit par adresse de votre plan — 2, 3 ou 5 requêtes par seconde, sur tous les domaines, décomptées par compte. Le plan Premium commence à $12,99 par mois. Voir les plans

La boîte de réception de ce site ne puise pas dans le quota gratuit de l'API : une page laissée ouverte continue de guetter le courrier tant que vous en avez besoin.

Au-delà d'une limite, vous recevez 429 avec un en-tête Retry-After exprimé en secondes entières : rate_limited pour la limite par minute ou par adresse, daily_limit_reached pour la limite quotidienne, avec le temps restant jusqu'à minuit UTC. En accès gratuit, chaque réponse vous indique où vous en êtes : X-RateLimit-Remaining pour la minute, X-RateLimit-Daily-Remaining pour la journée.

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", … }
}

Basez votre réessai sur Retry-After plutôt que sur un délai fixe. Si la limite change un jour, le code qui lit l'en-tête continue de fonctionner.

Taille des messages

Messages jusqu'à 5 MB, pièces jointes comprises. Cette limite est appliquée par le serveur de messagerie pendant la conversation SMTP, ce qui change tout : le serveur expéditeur en est informé au moment même où il essaie et signale un véritable échec à son utilisateur, au lieu de voir le message disparaître.

Ce qui compte

Le message encodé dans son intégralité — en-têtes, corps et toutes les pièces jointes après encodage MIME. Le Base64 gonfle un binaire d’environ un tiers, si bien qu’un fichier d’environ 3,5 Mo remplit déjà le plafond.

Ce qui se passe sur la ligne

Un 552 au moment SMTP. Le message n'est jamais stocké et n'apparaît jamais dans la boîte de messagerie.

Pièces jointes par message

Vingt. En pratique, c’est le plafond de taille qui arrive en premier — mais un message qui porte plus de vingt parties nommées ne conserve que les vingt premières.

Rétention

Un message est supprimé 5 jours après son arrivée, qu'il ait été lu ou non, et le compte à rebours démarre à la livraison plutôt qu'à la première lecture.

Chaque message porte expires_at, si bien qu'un client n'a jamais à calculer cette date ni à suivre la politique de conservation.

C'est une limite stricte, pas un réglage : aucun paramètre, plan ou compte ne la prolonge. Si quelque chose doit survivre à cette fenêtre, récupérez-le et stockez-le de votre côté.

Adresses et domaines

Adresses par domaine

Illimité, et non comptabilisé. Comme une boîte n’est jamais créée, il n’existe aucune liste qui puisse grandir.

Règles de la partie locale

De un à 64 caractères : lettres, chiffres, point, tiret, tiret bas et plus. Elle doit commencer et finir par une lettre ou un chiffre. Tout le reste est rejeté avant d'atteindre le serveur de messagerie, dans le navigateur puis à nouveau sur le serveur.

Adressage plus

name+tag@domain est ici une boîte distincte, pas un alias de name@domain. C'est voulu — les tags servent à séparer les inscriptions, et les fusionner mélangerait des boîtes censées rester séparées.

Casse

Tout est mis en minuscules. Name@ et name@ désignent la même boîte.

Domaines personnalisés

Aucune limite au nombre de domaines que vous pointez ici. Chacun a besoin de son propre enregistrement MX.

Quotas du pool premium

Tout ce qui précède décrit le service gratuit, et il le reste : les domaines publics et vos propres domaines n'ont ni quota de messages ni plafond d'adresses, sur tous les plans.

Un plan payant ajoute 97 domaines .com privés, tenus à l'écart des listes noires de courriel jetable. Seuls les messages arrivant sur CES domaines-là comptent dans un quota : Premium USD 12.99/month (2 000 premium messages/month, 1 API key, 2 req/s per address, no per-minute or daily API cap); Pro USD 49.99/month (15 000 premium messages/month, 5 API keys, 3 req/s per address, no per-minute or daily API cap); Scale USD 99.99/month (36 000 premium messages/month, 20 API keys, 5 req/s per address, no per-minute or daily API cap).

Une unité du quota correspond à un message reçu sur une adresse premium ou à une nouvelle adresse premium ouverte, selon ce qui arrive en premier. Avec une clé valable, le compte qui lit une adresse pour la première fois la tient désormais ; elle reste tenue — et gratuite à relire — jusqu'à ce qu'elle soit rendue depuis le tableau de bord ou que le plan expire. Aucun plan ne plafonne le nombre d'adresses qu'un compte tient.

Elles se lisent via les mêmes points d'accès, avec une clé Authorization: Bearer provenant d'un plan payant. Sans elle, une adresse premium répond 404 — la même réponse que pour un domaine que nous n'hébergeons pas, volontairement, afin que le pool ne puisse pas être énuméré en devinant des noms. Avec elle, 402 signifie que le quota est épuisé et 403 qu'un autre abonné tient l'adresse. Le tableau complet, ainsi que les appels qui vérifient une clé et listent le pool, se trouvent dans la référence de l'API.

Usage raisonnable

Il n’y a pas de quota que l’on puisse acheter pour le dépasser, ni de forfait qui relève ces chiffres. Ce qui existe à la place : si une seule source dégrade le service pour tout le monde, elle est stoppée.

Interrogation en masse

Des milliers de boîtes interrogées chaque seconde depuis une seule source seront limitées en périphérie avant d’atteindre l’API.

Inondations de courrier

Un hôte expéditeur qui ouvre un nombre déraisonnable de connexions SMTP est mis en attente pendant dix minutes. Les expéditeurs normaux n'en approchent jamais.

Nous utiliser comme relais

Impossible plutôt qu'interdit : le serveur de messagerie n'accepte que les messages adressés aux domaines hébergés ici, il ne peut donc rien transférer nulle part.

Rien de tout cela n'est pensé pour une automatisation ordinaire. Interroger le service une fois par seconde, toute la journée, sur des milliers de boîtes : c'est l'usage prévu, pas sa limite.