Reddit-API-Rate-Limits im Detail: 100 Abfragen pro Minute, gemittelt über zehn

Was ist das Rate-Limit der Reddit-API?

Die Data API von Reddit erzwingt Reddit-API-Rate-Limits von 100 Abfragen pro Minute pro OAuth-Client-ID, gemittelt über ein gleitendes Zehn-Minuten-Fenster, so das Reddit Data API Wiki. Die Mittelung prägt Ihr Design: Reddit misst den Durchschnitt über zehn Minuten statt jede Minute einzeln, Ihr echtes Budget liegt also bei 1.000 Abfragen pro Fenster und 6.000 pro Stunde, und Sie dürfen in einer einzelnen Minute über 100 hinausgehen, solange der Fensterdurchschnitt hält. Dimensionieren Sie Ihre Polling-Schleife am Fenster, nicht an der Schlagzeile von 100 pro Minute.

Limit	Wert	Wo Reddit es angibt
Authentifizierte Abfragen	100 Abfragen pro Minute (QPM) pro OAuth-Client-ID	Reddit Data API Wiki
Mittelungsfenster	Derzeit 10 Minuten, um Bursts zu ermöglichen	Reddit Data API Wiki
Effektives Fensterbudget	1.000 Abfragen pro gleitende 10 Minuten	Abgeleitet aus den beiden Zeilen darüber
Nicht authentifizierter Traffic	Wird komplett blockiert; das Standard-Rate-Limit gilt nicht	Reddit Data API Wiki
Chat-Nachrichten	2.000 pro Tag pro Empfänger, 3.000 pro Tag insgesamt	Reddit Data API Wiki
Chatrooms, Bot-Konten	Bis zu 300 Beitritte pro Tag	Reddit Data API Wiki
Alte veröffentlichte Zahl	60 Anfragen pro Minute für OAuth2-Clients	reddit-archive-Wiki auf GitHub

Zuletzt geprüft: 8. September 2026

Welche Zahl gilt aktuell, 60 oder 100?

Die aktuelle Zahl ist 100 QPM, und die 60 stammt aus Dokumentation, die Reddit selbst als veraltet kennzeichnet. Reddits archiviertes API-Wiki auf GitHub enthält weiterhin den Satz "Clients connecting via OAuth2 may make up to 60 requests per minute" (Clients, die sich über OAuth2 verbinden, dürfen bis zu 60 Anfragen pro Minute stellen) und trägt keinen Versionsstempel, weshalb er immer wieder in Antworten auf Stack Overflow auftaucht. Das im Support gehostete Data API Wiki, das mit Reddits Warnung öffnet, alte API-Dokumentation "may be out of date" (könnte veraltet sein), ist die Seite, die 100 QPM und den Zehn-Minuten-Durchschnitt nennt. Bauen Sie gegen 100 QPM, und datieren Sie jede Quelle, die 60 nennt, auf die Zeit vor 2023.

Die Zugangsregeln haben sich im selben Zeitraum verschoben. Reddits Data API Terms tragen das Inkrafttretungsdatum 19. Juni 2023 und die letzte Überarbeitung 20. Juli 2026, alles vor Mitte 2023 beschreibt also ein anderes Produkt. Lesen Sie was der Data-API-Zugang kostet, sobald die kostenlose Berechtigung endet zusammen mit diesen Limits.

Wie liest man die X-Ratelimit-Antwortheader?

Reddit meldet Ihr verbleibendes Budget in jeder Antwort der Data API über drei Header. Das Data API Wiki definiert sie genau so.

Header	Was Reddit dazu angibt
X-Ratelimit-Used	Approximate number of requests used in this period (ungefähre Zahl der in diesem Zeitraum genutzten Anfragen)
X-Ratelimit-Remaining	Approximate number of requests left to use (ungefähre Zahl der noch verfügbaren Anfragen)
X-Ratelimit-Reset	Approximate number of seconds to end of period (ungefähre Zahl der Sekunden bis zum Ende des Zeitraums)

Zwei Details beißen. Reddit nennt alle drei Werte approximate, also ungefähr, sodass ein Client, der bis auf X-Ratelimit-Remaining: 0 herunterfährt, Fehler sammelt statt sauber zu stoppen. HTTP/2 schreibt Headernamen auf der Leitung zudem klein, Ihr Client sieht also x-ratelimit-remaining, während die Doku Title Case schreibt; vergleichen Sie ohne Rücksicht auf Groß- und Kleinschreibung. Loggen Sie alle drei und alarmieren Sie, wenn der Restwert unter eine von Ihnen gewählte Untergrenze fällt. PRAW berücksichtigt diese Header automatisch und verteilt seine Anfragen entsprechend.

Was passiert, wenn Reddit 429 zurückgibt?

Reddit antwortet mit HTTP 429 Too Many Requests, sobald Sie den Fensterdurchschnitt überschreiten, und die Antwort kann einen retry-after-Header mit der Wartezeit tragen. Die Referenzimplementierung ist prawcore, die HTTP-Schicht unter PRAW: dessen sessions.py bildet too_many_requests auf eine TooManyRequests-Exception ab, die retry-after aus der Antwort liest. Bemerkenswert: 429 fehlt in prawcores Menge RETRY_STATUSES, die 500, 502, 503, 504, 408, 520 und 522 enthält, PRAW wirft bei 429 also einen Fehler, statt still erneut zu versuchen.

Übernehmen Sie diese Entscheidung. Ein Serverfehler verdient einen erneuten Versuch, weil die Anfrage gültig war, aber ein 429 Too Many Requests heißt, dass Ihr Scheduler falsch liegt, und ihn in einer Retry-Schleife zu vergraben, verdeckt den Fehler und verbrennt Kontingent. Machen Sie die 429 sichtbar und korrigieren Sie den Zeitplan.

Wie viele Keywords kann eine OAuth-Client-ID pro Stunde abfragen?

Teilen Sie das Stundenbudget durch die Kosten pro Keyword, und ein auf Subreddits begrenzter Monitor landet im niedrigen zweistelligen Bereich. Die Arithmetik ist eine Zeile:

Queries per hour = keywords x subreddits x (60 / poll interval in minutes) x pages per poll

Verfolgen Sie ein Keyword über 12 Subreddits, fragen Sie alle 5 Minuten ab und holen Sie eine Seite pro Abfrage:

1 x 12 x (60 / 5) x 1 = 144 queries per hour per keyword

Ihre Obergrenze liegt bei 100 QPM x 60 Minuten = 6.000 Abfragen pro Stunde, also 6.000 / 144 = 41,6, was 41 Keywords ohne jede Reserve bedeutet. Holen Sie zwei Seiten pro Abfrage, verdoppeln sich die Kosten auf 288 pro Keyword und Stunde und Sie fallen auf 20 Keywords. Halten Sie 20 Prozent für Token-Refreshes und Wiederholungen zurück, wird die Ein-Seiten-Obergrenze zu 4.800 / 144 = 33 Keywords.

Bursts sind separat begrenzt. Jede gleitende Zehn-Minuten-Spanne fasst 1.000 Abfragen, ein Backfill mit 900 Anfragen in der ersten Minute lässt also 100 für die folgenden neun. Betreiben Sie laufendes Monitoring und Backfills unter getrennten OAuth-Client-IDs. Diese Rechnung entscheidet, ob Sie überhaupt auf der Roh-API bauen, und sie steckt auch hinter RedReplier neben dem Eigenbetrieb der Reddit-API.

Keyword-Obergrenze pro OAuth-Client-ID

Eine Seite pro Abfrage41 Keywords

Zwei Seiten pro Abfrage20 Keywords

Eine Seite, 20 % Puffer zurückgehalten33 Keywords

Wie sieht exponentielles Backoff gegen einen Zehn-Minuten-Durchschnitt aus?

Backoff heißt hier: die Wartezeit nach jedem Fehlschlag verdoppeln und zufälligen Jitter addieren, damit eine Flotte von Workern nicht im Gleichtakt wiederholt. Ein Zeitplan, der zum Zehn-Minuten-Fenster passt: 1, 2, 4, 8 und 16 Sekunden über fünf Versuche warten, jeweils bis zu 1 Sekunde Jitter addieren, jede Wartezeit bei 60 Sekunden deckeln und die Anfrage nach dem fünften Versuch aufgeben. Wenn Reddit retry-after sendet, nutzen Sie diesen Wert statt Ihres berechneten.

Prawcores eigene Strategie ist bewusst kleiner: FiniteRetryStrategy setzt DEFAULT_RETRIES = 2 und schläft 2 * random() Sekunden vor dem ersten Versuch und 2 + 2 * random() vor dem letzten. Übernehmen Sie den Jitter und den harten Abbruch, denn unbegrenzte Wiederholungen gegen ein gemitteltes Fenster graben das Loch tiefer: jeder Versuch zählt auf denselben Zehn-Minuten-Durchschnitt ein, der die 429 erzeugt hat. Wenn Ihr System exponentielles Backoff braucht, um im Budget zu bleiben, ist der Zeitplan der Defekt, und die Wahl zwischen Polling und Webhooks ist das nützlichere Gespräch.

Was trennt die kostenlose Data-API-Stufe von der kommerziellen Lizenzierung?

Die Trennlinie ist, was Sie mit den Daten tun, nicht wie viele Abfragen Sie senden. Reddits Help-Center-Artikel zum Zugriff auf Reddit-Daten definiert kommerzielle Zwecke als "any use of our services by a business or on behalf of a business or as part of a monetized product or service" (jede Nutzung unserer Dienste durch ein Unternehmen oder in dessen Auftrag oder als Teil eines monetarisierten Produkts oder Dienstes) und nennt als Beispiele unter anderem Abodienste, Apps hinter einer Paywall und kostenpflichtigen Datenzugang. Abschnitt 3.1 der Data API Terms formuliert es als Vertragstext: kommerzielle Zwecke, Nutzung über die Rate-Limits hinaus oder alles nicht ausdrücklich Erlaubte "will need to enter into a separate agreement with Reddit." (erfordert eine gesonderte Vereinbarung mit Reddit).

Ein monetarisiertes Produkt mit 10 Abfragen pro Minute braucht also einen Vertrag, obwohl es die Obergrenze nie erreicht. Akademische Arbeit läuft inzwischen ausschließlich über das Programm Reddit for Researchers, und Reddits Responsible Builder Policy stellt fest, dass Forschung an außerhalb davon erhobenen Daten gegen die Richtlinie verstößt, mit Durchsetzung bis hin zu entzogenen Tokens und gesperrten Konten. Klären Sie vor dem ersten Client, auf welcher Seite der Linie Sie stehen.

Jede Zahl oben gilt, weil Sie die OAuth-Client-ID halten. RedReplier beobachtet Reddit zusammen mit X, Bluesky, Facebook und Hacker News an einem Ort, Abdeckung wird damit zu einer Tarifeinstellung statt zu einer Rechnung über Abfragen pro Stunde. Es bietet außerdem eine API und einen MCP-Server, der mit Claude Code, Cursor und jedem Standard-MCP-Client funktioniert.

Häufig gestellte Fragen

Gilt das Limit von 100 QPM pro Nutzer oder pro App?

Pro OAuth-Client-ID, laut Reddits Data API Wiki. Jeder Nutzer, den Ihre App authentifiziert, schöpft aus demselben Pool von 100 QPM, der an diese Client-ID gebunden ist, ein mandantenfähiges Tool gewinnt durch zusätzliche Nutzer also keinen Spielraum. Getrennte Client-IDs für tatsächlich getrennte Anwendungen zu registrieren, ist der unterstützte Weg, Budgets aufzuteilen.

Was passiert mit Anfragen, die OAuth komplett überspringen?

Reddit blockiert sie. Das Data API Wiki stellt fest, dass Traffic ohne OAuth oder Login-Daten blockiert wird und das Standard-Rate-Limit nicht gilt, und sein Abschnitt Rules ergänzt, Reddit könne "freely throttle or block unidentified Data API users." (nicht identifizierte Data-API-Nutzer nach Belieben drosseln oder blockieren). Es gibt keinen unauthentifizierten Freibetrag, mit dem sich planen ließe.

Zeigen die X-Ratelimit-Header die Minute oder das Zehn-Minuten-Fenster?

Sie melden den aktuellen Zeitraum, und das ist das Zehn-Minuten-Mittelungsfenster. X-Ratelimit-Reset zählt die Sekunden bis zum Ende dieses Zeitraums herunter, ein Wert nahe 600 heißt also, das Fenster hat gerade begonnen, ein Wert nahe 0 heißt, Ihr Kontingent wird gleich erneuert. Reddit bezeichnet alle drei als approximate, also ungefähr, lassen Sie daher Reserve, statt bis auf null zu gehen.

Sendet Reddit bei 429 immer einen Retry-After-Header?

Nein. Prawcores TooManyRequests-Exception liest den Header mit response.headers.get("retry-after") und gibt nur dann einen Hinweis auf die Wartezeit aus, wenn er vorhanden ist, Ihr Code muss sein Fehlen also abfangen. Nutzen Sie retry-after, wenn er kommt, und fallen Sie auf Ihren eigenen Backoff-Zeitplan zurück, wenn nicht.

Ist ein User-Agent-String Pflicht?

Ja, und das Format ist vorgeschrieben. Reddits Data API Wiki verlangt <platform>:<app ID>:<version string> (by /u/<reddit username>) und merkt an, dass Standardwerte wie "Python/urllib" oder "Java" "drastically limited." (drastisch limitiert) sind. Es warnt außerdem: "NEVER lie about your User-Agent." (Lügen Sie NIEMALS über Ihren User-Agent.)

Kann ich das Limit ohne kommerziellen Vertrag anheben?

Für Moderator-Bots gibt es einen dokumentierten Weg: Reddits Data API Wiki lädt Betreiber von Mod-Bots, die über die Limits hinausmüssen, ein, sich über sein Kontaktformular zu melden. Reddits Help Center ergänzt, dass ausgewählten Entwicklern mit Bedarf an breiterem Zugang Gebühren für das Anheben der Standardlimits berechnet werden können. Für alles Monetarisierte ist der Weg die gesonderte Vereinbarung aus Abschnitt 3.1 der Data API Terms.

Gilt das 100-QPM-Limit auch für Reddit-Chat-Nachrichten?

Chat läuft unter eigenen Obergrenzen, getrennt vom 100-QPM-Abfragelimit: 2.000 Nachrichten pro Tag und Empfänger sowie 3.000 pro Tag insgesamt, laut Data API Wiki. Bot-Konten dürfen zusätzlich bis zu 300 Chatraum-Beitritte pro Tag vornehmen. Keiner dieser Werte zehrt vom selben rollierenden Zehn-Minuten-Fenster wie die regulären Abfragen.

Wie behandelt Reddit 429 anders als einen Serverfehler?

Das RETRY_STATUSES-Set von prawcore umfasst 500, 502, 503, 504, 408, 520 und 522, also die Codes, bei denen die Anfrage gültig war und der Server gestolpert ist, weshalb PRAW diese automatisch wiederholt. 429 steht bewusst außerhalb dieses Sets. Prawcore wirft stattdessen eine TooManyRequests-Exception, weil ein Rate-Limit-Fehler bedeutet, dass der Zeitplan falsch ist, nicht der Server.

Was passiert mit akademischer Forschung, die das Reddit-for-Researchers-Programm umgeht?

Reddits Responsible Builder Policy wertet Daten, die außerhalb des Reddit-for-Researchers-Programms gesammelt wurden, als Verstoß. Die Durchsetzung reicht bis zu widerrufenen Tokens und gesperrten Konten. Akademische Projekte sollen über das Programm laufen, statt Daten über eine allgemeine OAuth-Client-ID zu ziehen.

Warum braucht ein Backfill eine eigene OAuth-Client-ID getrennt vom laufenden Monitoring?

Jedes rollierende Zehn-Minuten-Fenster fasst insgesamt 1.000 Abfragen, und ein Backfill, der in der ersten Minute 900 Anfragen abfeuert, lässt nur noch 100 für die restlichen neun übrig. Läuft dieser Backfill über dieselbe Client-ID wie das laufende Monitoring, hungert das Monitoring für den Rest des Fensters. Getrennte Client-IDs geben jedem Job sein eigenes Budget von 1.000 Abfragen.