Limits

Auf einen Blick

• 1–5/sek

  API-Anfragen pro Adresse

  Eine ohne Schlüssel; 2, 3 oder 5 mit einem Schlüssel aus einem bezahlten Tarif. Einmal pro Sekunde abzufragen ist das vorgesehene Muster.

• 60/min

  Kostenlose API-Anfragen pro Minute

  Pro IP-Adresse, ohne Schlüssel. Bezahlte Tarife haben kein Minutenlimit.

• 1.000/Tag

  Kostenlose API-Anfragen pro Tag

  Pro IP-Adresse, zurückgesetzt um 00:00 UTC. Bezahlte Tarife haben kein Tageslimit.

• 5Tage

  Aufbewahrungsdauer von Nachrichten

  Ab Eingang, gelesen oder nicht. Feste Frist.

• 5MB

  Maximale Nachrichtengröße

  Wird bereits bei SMTP abgelehnt, sodass der Absender informiert wird.

• ∞

  Adressen pro Domain

  Nichts wird im Voraus angelegt, also wird auch nichts gezählt.

• 200

  Nachrichten pro Aufruf

  Standard 50. Das begrenzt nur eine Antwort, nicht das Postfach: next blättert durch den Rest, egal wie viele es sind.

• 0

  Ausgehende Nachrichten

  Es gibt keinen Sende-Endpunkt. Mit Absicht.

Ratenlimits

Kostenlos, ohne Schlüssel: 60 Anfragen pro Minute und 1.000 pro Tag, je IP-Adresse. Jeder Zugriff auf ein Postfach zählt — Auflisten, Lesen einer Nachricht, ihres HTML-Inhalts oder eines Anhangs, Löschen — und ebenso jeder Aufruf eines MCP-Tools. Der Tageszähler wird um 00:00 UTC zurückgesetzt.

Innerhalb dieses Rahmens gilt ein Lesevorgang pro Sekunde und Adresse: Ein Postfach einmal pro Sekunde abzufragen ist der vorgesehene Rhythmus.

Mit einem kostenlosen API-Schlüssel folgt dasselbe Kontingent Ihrem Konto statt Ihrer IP-Adresse — praktisch, wenn Ihre Aufrufe von wechselnden Adressen kommen, etwa von einem CI-Runner. Ein kostenloses Konto hat einen Schlüssel, und die Postfächer, die er liest, erscheinen in Ihren Postfächern. Kostenlosen Schlüssel anlegen

Bezahlte Tarife haben weder ein Minuten- noch ein Tageslimit. Senden Sie den Schlüssel eines bezahlten Tarifs als Authorization: Bearer, und es gilt nur noch die Rate pro Adresse Ihres Tarifs — 2, 3 oder 5 Anfragen pro Sekunde, auf jeder Domain, pro Konto gezählt. Premium gibt es schon ab $12,99 im Monat. Tarife ansehen

Das Postfach auf dieser Website belastet das kostenlose API-Kontingent nicht: Eine offen gelassene Seite prüft weiter auf neue Post, solange Sie sie brauchen.

Wird ein Limit überschritten, erhalten Sie 429 mit einem Retry-After-Header in ganzen Sekunden: rate_limited für das Limit pro Minute oder pro Adresse, daily_limit_reached für das Tageslimit, mit der verbleibenden Zeit bis Mitternacht UTC. Jede kostenlose Antwort zeigt Ihnen, wo Sie stehen: X-RateLimit-Remaining für die Minute, X-RateLimit-Daily-Remaining für den Tag.

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

Warten Sie gemäß Retry-After, statt eine feste Pause einzubauen. Ändert sich das Limit, funktioniert Code, der den Header ausliest, weiterhin.

Nachrichtengröße

Nachrichten bis 5 MB, Anhänge eingerechnet. Diese Grenze wird vom Mailserver während der SMTP-Verbindung durchgesetzt – das ist wichtig: Der sendende Server erfährt es im Moment des Versuchs und meldet seinem Nutzer einen echten Fehler, statt dass die Nachricht einfach verschwindet.

Was zählt

Die gesamte kodierte Nachricht — Header, Text und jeder Anhang nach der MIME-Kodierung. Base64 bläht eine Binärdatei um etwa ein Drittel auf, sodass eine Datei von rund 3,5 MB die Grenze bereits ausfüllt.

Was auf der Leitung passiert

Ein 552 zum SMTP-Zeitpunkt. Die Nachricht wird nie gespeichert und erscheint nie im Postfach.

Anhänge pro Nachricht

Zwanzig. In der Praxis wird zuerst die Größengrenze erreicht — aber eine Nachricht mit mehr als zwanzig Teilen mit Dateinamen behält die ersten zwanzig.

Aufbewahrung

Eine Nachricht wird 5 Tage nach ihrem Eintreffen gelöscht, gelesen oder nicht, und die Frist beginnt mit der Zustellung, nicht mit dem ersten Lesen.

Jede Nachricht trägt expires_at, sodass ein Client dieses Datum nie selbst berechnen oder die Regel im Blick behalten muss.

Es ist eine feste Frist, keine Einstellung: Kein Parameter, Plan oder Konto verlängert sie. Muss etwas länger erhalten bleiben, holen und speichern Sie es auf Ihrer Seite.

Adressen und Domains

Adressen pro Domain

Unbegrenzt und nicht gezählt. Da ein Postfach nie erstellt wird, gibt es keine Liste davon, die wachsen könnte.

Regeln für den Lokalteil

Ein bis 64 Zeichen: Buchstaben, Ziffern, Punkt, Bindestrich, Unterstrich und Pluszeichen. Sie muss mit einem Buchstaben oder einer Ziffer beginnen und enden. Alles andere wird abgelehnt, bevor es den Mailserver erreicht – im Browser und erneut auf dem Server.

Plus-Adressierung

name+tag@domain ist hier ein eigenständiges Postfach, kein Alias von name@domain. Das ist Absicht — Tags dienen dazu, Anmeldungen zu trennen, und sie zusammenzuführen würde Postfächer vermischen, die getrennt bleiben sollten.

Groß-/Kleinschreibung

Alles wird klein geschrieben. Name@ und name@ sind dasselbe Postfach.

Eigene Domains

Keine Begrenzung, wie viele Domains Sie hierher zeigen lassen. Jede braucht ihren eigenen MX-Eintrag.

Kontingente des Premium-Pools

Alles Obige beschreibt den kostenlosen Dienst, und der bleibt es: Die öffentlichen Domains und Ihre eigenen haben in keinem Tarif ein Nachrichtenkontingent oder eine Adressgrenze.

Ein bezahlter Tarif ergänzt 97 private .com-Domains, die von den Blocklisten für Wegwerf-Mail ferngehalten werden. Nur Nachrichten, die auf DIESEN Domains eintreffen, zählen gegen ein Kontingent: 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).

Eine Einheit des Kontingents ist eine auf einer Premium-Adresse empfangene Nachricht oder eine neu geöffnete Premium-Adresse, je nachdem, was zuerst eintritt. Der erste Lesevorgang einer Adresse mit einem gültigen Schlüssel hält sie für das Konto; sie bleibt gehalten — und kostenlos erneut lesbar — bis sie im Dashboard freigegeben wird oder der Tarif endet. Kein Tarif begrenzt, wie viele Adressen ein Konto hält.

Sie werden über dieselben Endpunkte gelesen, mit einem Authorization: Bearer-Schlüssel aus einem bezahlten Tarif. Ohne ihn antwortet eine Premium-Adresse 404 — dieselbe Antwort wie bei einer Domain, die wir nicht hosten, absichtlich, damit der Pool nicht durch Erraten von Namen aufgelistet werden kann. Mit ihm bedeutet 402, dass das Kontingent aufgebraucht ist, und 403, dass ein anderer Abonnent die Adresse hält. Die vollständige Tabelle sowie die Aufrufe, die einen Schlüssel prüfen und den Pool auflisten, stehen in die API-Referenz.

Angemessene Nutzung

Es gibt kein Kontingent, das Sie sich freikaufen können, und keinen Tarif, der diese Werte anhebt. Stattdessen gilt: Wenn eine einzelne Quelle den Dienst für alle anderen verschlechtert, wird sie gestoppt.

Massenabfragen

Tausende Postfächer, die jede Sekunde von einer Quelle abgefragt werden, werden am Rand gedrosselt, bevor sie die API erreichen.

Mail-Fluten

Ein sendender Host, der unverhältnismäßig viele SMTP-Verbindungen öffnet, wird für zehn Minuten gesperrt. Normale Absender kommen dem nie nahe.

Uns als Relay verwenden

Unmöglich statt verboten: Der Mailserver nimmt nur Nachrichten an, die an hier gehostete Domains adressiert sind, und kann daher nichts weiterleiten.

Nichts davon ist für gelegentliche Automatisierung gedacht. Einmal pro Sekunde abfragen, den ganzen Tag, über Tausende Postfächer hinweg – das ist der vorgesehene Gebrauch, nicht sein Grenzfall.