TL;DR
7 min czytaniaData API Reddita pozwala na 100 zapytań na minutę na client id OAuth, uśrednionych w kroczącym oknie dziesięciu minut, co daje 1 000 zapytań na okno i 6 000 na godzinę. Każda odpowiedź zawiera X-Ratelimit-Used, X-Ratelimit-Remaining i X-Ratelimit-Reset, więc pozostałą pulę możesz odczytać przed jej wydaniem. Po przekroczeniu limitu Reddit odpowiada kodem 429, a użycie komercyjne wymaga osobnej umowy bez względu na liczbę zapytań.
Jaki jest limit zapytań API Reddita?
Data API Reddita ogranicza ruch do 100 zapytań na minutę na client id OAuth, uśrednionych w kroczącym oknie dziesięciu minut, jak podaje Reddit Data API Wiki. To uśrednianie kształtuje projekt systemu: Reddit mierzy średnią z dziesięciu minut, a nie każdą minutę osobno, więc twoja realna pula to 1 000 zapytań na okno i 6 000 na godzinę, a w pojedynczej minucie możesz przekroczyć 100, dopóki średnia z okna się zgadza. Pętlę odpytywania dopasuj do okna, a nie do nagłówkowej liczby na minutę.
| Limit | Wartość | Gdzie podaje to Reddit |
|---|---|---|
| Zapytania uwierzytelnione | 100 zapytań na minutę (QPM) na client id OAuth | Reddit Data API Wiki |
| Okno uśredniania | Obecnie 10 minut, aby umożliwić skoki ruchu | Reddit Data API Wiki |
| Efektywna pula okna | 1 000 zapytań na kroczące 10 minut | Wynika z dwóch powyższych wierszy |
| Ruch nieuwierzytelniony | Blokowany, domyślny limit nie ma zastosowania | Reddit Data API Wiki |
| Wiadomości na czacie | 2 000 dziennie na odbiorcę, łącznie 3 000 dziennie | Reddit Data API Wiki |
| Pokoje czatu, konta botów | Do 300 dołączeń dziennie | Reddit Data API Wiki |
| Dawna opublikowana wartość | 60 zapytań na minutę dla klientów OAuth2 | wiki reddit-archive na GitHubie |
Ostatnia weryfikacja: 8 września 2026
Która liczba jest aktualna: 60 czy 100?
Aktualna wartość to 100 QPM, a 60 pochodzi z dokumentacji, którą sam Reddit oznacza jako przestarzałą. Zarchiwizowana wiki API na GitHubie nadal mówi "Clients connecting via OAuth2 may make up to 60 requests per minute" i nie ma oznaczenia wersji, dlatego wciąż wraca w odpowiedziach na Stack Overflow. Data API Wiki w centrum pomocy, która zaczyna się od ostrzeżenia, że starsza dokumentacja "may be out of date", to strona podająca 100 QPM i średnią z dziesięciu minut. Projektuj pod 100 QPM, a każde źródło cytujące 60 traktuj jako sprzed 2023 roku.
W tym samym czasie zmieniły się zasady dostępu. Data API Terms obowiązują od 19 czerwca 2023 roku, a ostatnio zmieniono je 20 lipca 2026 roku, więc wszystko starsze niż połowa 2023 roku opisuje inny produkt. Razem z tymi limitami przeczytaj, ile kosztuje dostęp do Data API po utracie darmowego uprawnienia.
Jak czytać nagłówki odpowiedzi X-Ratelimit?
Reddit podaje pozostałą pulę w każdej odpowiedzi Data API przez trzy nagłówki. Data API Wiki definiuje je dokładnie tak.
| Nagłówek | Co według Reddita podaje |
|---|---|
X-Ratelimit-Used | Przybliżona liczba zapytań użytych w tym okresie |
X-Ratelimit-Remaining | Przybliżona liczba pozostałych zapytań |
X-Ratelimit-Reset | Przybliżona liczba sekund do końca okresu |
Dwa szczegóły potrafią zaboleć. Reddit nazywa wszystkie trzy wartości przybliżonymi, więc klient, który schodzi do X-Ratelimit-Remaining: 0, dostaje błędy, zamiast zatrzymać się w porę. HTTP/2 zapisuje też nazwy nagłówków małymi literami, więc klient widzi x-ratelimit-remaining, choć dokumentacja używa wielkich liter, dlatego dopasowuj je bez rozróżniania wielkości. Loguj wszystkie trzy i ustaw alert, gdy pozostała liczba spadnie poniżej wybranego progu. PRAW automatycznie respektuje te nagłówki i odpowiednio rozkłada zapytania.
Co się dzieje, gdy Reddit zwraca 429?
Po przekroczeniu średniej z okna Reddit odpowiada kodem HTTP 429 Too Many Requests, a odpowiedź może zawierać nagłówek retry-after z czasem oczekiwania. Wzorcową implementacją jest prawcore, warstwa HTTP pod PRAW: jego sessions.py mapuje too_many_requests na wyjątek TooManyRequests, który odczytuje retry-after z odpowiedzi. Co istotne, kodu 429 nie ma w zbiorze RETRY_STATUSES prawcore, zawierającym 500, 502, 503, 504, 408, 520 i 522, więc PRAW przy 429 zgłasza wyjątek, zamiast po cichu ponawiać.
Skopiuj ten wybór. Błąd serwera zasługuje na ponowienie, bo zapytanie było poprawne, ale 429 Too Many Requests oznacza, że źle działa twój harmonogram, a ukrycie tego w pętli ponowień maskuje błąd i spala limit. Pokaż 429 i popraw harmonogram.

Ile słów kluczowych może odpytywać jeden client id OAuth na godzinę?
Podziel godzinową pulę przez koszt jednego słowa kluczowego, a monitor ograniczony do subredditów wypadnie w niskich dziesiątkach. Rachunek mieści się w jednym wierszu:
Queries per hour = keywords x subreddits x (60 / poll interval in minutes) x pages per poll
Śledź jedno słowo kluczowe w 12 subredditach, odpytuj co 5 minut i pobieraj jedną stronę na odpytanie:
1 x 12 x (60 / 5) x 1 = 144 queries per hour per keyword
Twój sufit to 100 QPM x 60 minut = 6 000 zapytań na godzinę, więc 6 000 / 144 = 41,6, czyli 41 słów kluczowych bez żadnego zapasu. Pobieraj dwie strony na odpytanie, a koszt podwoi się do 288 na słowo kluczowe na godzinę, co daje 20 słów kluczowych. Zostaw 20% na odświeżanie tokenów i ponowienia, a sufit dla jednej strony spadnie do 4 800 / 144 = 33 słów kluczowych.
Skoki ruchu mają osobne ograniczenie. Każde kroczące dziesięć minut mieści 1 000 zapytań, więc uzupełnianie danych historycznych wysyłające 900 zapytań w pierwszej minucie zostawia 100 na kolejne dziewięć. Stałe monitorowanie i uzupełnianie historii uruchamiaj na osobnych client id OAuth. Ten rachunek decyduje, czy w ogóle budować na surowym API, i to ten sam, który stoi za porównaniem RedReplier z samodzielnym używaniem API Reddita.
RedReplier
Rozpocznij
Reddit, X, Bluesky i HN
Alerty o intencjach w czasie rzeczywistym
Nielimitowane odpowiedzi AI
Ocena według intencji zakupowej

Jak wygląda wykładnicze wycofanie przy średniej z dziesięciu minut?
Wycofanie (backoff) oznacza tu podwajanie czasu oczekiwania po każdym niepowodzeniu i dodawanie losowego odchylenia, aby flota procesów nie ponawiała zapytań jednocześnie. Harmonogram pasujący do dziesięciominutowego okna: czekaj 1, 2, 4, 8 i 16 sekund w pięciu próbach, do każdej dodaj do 1 sekundy losowego odchylenia, ogranicz każde oczekiwanie do 60 sekund i porzuć zapytanie po piątej próbie. Gdy Reddit przyśle retry-after, użyj tej wartości zamiast obliczonej.
Własna strategia prawcore jest celowo skromniejsza: FiniteRetryStrategy ustawia DEFAULT_RETRIES = 2 i czeka 2 * random() sekund przed pierwszym ponowieniem oraz 2 + 2 * random() przed ostatnim. Skopiuj losowe odchylenie i twardy limit prób, bo nieograniczone ponowienia przy uśrednianym oknie tylko pogłębiają problem: każde ponowienie wlicza się do tej samej średniej z dziesięciu minut, która wywołała 429. Jeśli system potrzebuje wykładniczego wycofania, by zmieścić się w puli, wadliwy jest harmonogram, a bardziej przydatna będzie rozmowa o wyborze między odpytywaniem a webhookami.
Co odróżnia darmowy poziom Data API od licencji komercyjnej?
Granicę wyznacza to, co robisz z danymi, a nie liczba zapytań. Artykuł centrum pomocy o dostępie do danych Reddita definiuje cele komercyjne jako "any use of our services by a business or on behalf of a business or as part of a monetized product or service", a wśród przykładów wymienia usługi subskrypcyjne, płatne aplikacje i płatny dostęp do danych. Sekcja 3.1 Data API Terms ujmuje to językiem umowy: cele komercyjne, użycie ponad limity lub cokolwiek, na co wyraźnie nie zezwolono, "will need to enter into a separate agreement with Reddit."
Monetyzowany produkt wysyłający 10 zapytań na minutę potrzebuje więc umowy, choć nawet nie zbliża się do sufitu. Prace akademickie przechodzą teraz wyłącznie przez program Reddit for Researchers, a Responsible Builder Policy stwierdza, że badania na danych zebranych poza nim naruszają zasady, z konsekwencjami sięgającymi unieważnienia tokenów i zawieszenia kont. Ustal, po której stronie granicy stoisz, zanim napiszesz klienta.
Wszystkie powyższe liczby dotyczą cię dlatego, że masz własny client id OAuth. RedReplier obserwuje Reddita razem z X, Bluesky, Facebookiem i Hacker News w jednym miejscu, więc zakres monitoringu staje się ustawieniem planu, a nie rachunkiem zapytań na godzinę. Udostępnia też API i serwer MCP działający z Claude Code, Cursorem i każdym standardowym klientem MCP.
Najczęściej zadawane pytania
Czy limit 100 QPM dotyczy użytkownika, czy aplikacji?
Dotyczy client id OAuth, jak podaje Data API Wiki. Każdy użytkownik uwierzytelniony przez twoją aplikację korzysta z tej samej puli 100 QPM przypisanej do client id, więc narzędzie dla wielu klientów nie zyskuje zapasu, dodając użytkowników. Wspieranym sposobem podziału puli jest rejestracja osobnych client id dla faktycznie odrębnych aplikacji.
Co dzieje się z zapytaniami, które pomijają OAuth?
Reddit je blokuje. Data API Wiki stwierdza, że ruch bez OAuth lub danych logowania będzie blokowany, a domyślny limit nie ma zastosowania, a sekcja Rules dodaje, że Reddit może "freely throttle or block unidentified Data API users." Nie ma żadnej puli dla ruchu nieuwierzytelnionego, na której można by się oprzeć.
Czy nagłówki X-Ratelimit pokazują minutę, czy okno dziesięciu minut?
Podają bieżący okres, czyli dziesięciominutowe okno uśredniania. X-Ratelimit-Reset odlicza sekundy do jego końca, więc wartość bliska 600 oznacza, że okno właśnie się otworzyło, a bliska 0, że pula zaraz się odnowi. Reddit nazywa wszystkie trzy przybliżonymi, więc zostaw zapas, zamiast schodzić do zera.
Czy Reddit zawsze wysyła nagłówek Retry-After przy 429?
Nie. Wyjątek TooManyRequests w prawcore odczytuje nagłówek przez response.headers.get("retry-after") i wypisuje instrukcję oczekiwania tylko wtedy, gdy nagłówek istnieje, więc twój kod musi obsłużyć jego brak. Użyj retry-after, gdy się pojawi, a w przeciwnym razie wróć do własnego harmonogramu wycofania.
Czy User-Agent jest wymagany?
Tak, a format jest ściśle określony. Data API Wiki wymaga <platform>:<app ID>:<version string> (by /u/<reddit username>) i zaznacza, że domyślne wartości, takie jak "Python/urllib" czy "Java", są "drastically limited." Ostrzega też: "NEVER lie about your User-Agent."
Czy mogę podnieść limit bez umowy komercyjnej?
Boty moderatorskie mają udokumentowaną drogę: Data API Wiki zachęca ich operatorów, którzy muszą przekroczyć limity, do kontaktu przez formularz. Centrum pomocy dodaje, że wybrani deweloperzy potrzebujący szerszego dostępu mogą płacić za zniesienie domyślnych limitów. Przy wszystkim, co jest monetyzowane, drogą jest osobna umowa z sekcji 3.1 Data API Terms.
Czy limit 100 QPM obejmuje też wiadomości na czacie Reddita?
Czat ma własne limity, niezależne od 100 QPM: 2 000 wiadomości dziennie na odbiorcę i łącznie 3 000 dziennie, jak podaje Data API Wiki. Konta botów mogą dodatkowo dołączać do 300 pokojów czatu dziennie. Nic z tego nie korzysta z tego samego kroczącego okna co zwykłe zapytania.
Czym dla Reddita różni się 429 od błędu serwera?
Zbiór RETRY_STATUSES w prawcore obejmuje 500, 502, 503, 504, 408, 520 i 522, czyli kody oznaczające, że zapytanie było poprawne, a serwer się potknął, więc PRAW ponawia je automatycznie. Kod 429 celowo jest poza tym zbiorem. Prawcore zgłasza zamiast tego wyjątek TooManyRequests, bo błąd limitu oznacza, że zły jest twój harmonogram, a nie serwer.
Co grozi badaniom akademickim prowadzonym poza programem Reddit for Researchers?
Responsible Builder Policy traktuje dane zebrane poza programem Reddit for Researchers jako naruszenie. Konsekwencje sięgają unieważnienia tokenów i zawieszenia kont. Projekty akademickie powinny korzystać z programu, zamiast pobierać dane przez zwykły client id OAuth.
RedReplier
Rozpocznij
Reddit, X, Bluesky i HN
Alerty o intencjach w czasie rzeczywistym
Nielimitowane odpowiedzi AI
Ocena według intencji zakupowej
Dlaczego uzupełnianie historii potrzebuje innego client id OAuth niż stałe monitorowanie?
Każde kroczące okno dziesięciu minut mieści łącznie 1 000 zapytań, a uzupełnianie historii wysyłające 900 zapytań w pierwszej minucie zostawia tylko 100 na pozostałe dziewięć. Na tym samym client id co stały monitoring zagłodzi go do końca okna. Osobne client id dają każdemu zadaniu własną pulę 1 000 zapytań.
Więcej naszych treści w Google
Jedno kliknięcie oznacza RedReplier jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
RedReplier
Żaden kupujący pytający o ofertę nie umknie
RedReplier śledzi Reddita, X, Bluesky i Hacker News w czasie rzeczywistym, ocenia każdy wątek pod kątem intencji zakupowej i przygotowuje odpowiedź, by dotrzeć tam jako pierwszy.
Reddit, X, Bluesky i HN
Alerty o intencjach w czasie rzeczywistym
Nielimitowane odpowiedzi AI
Ocena według intencji zakupowej
Powiązane artykuły


Kiedy scraping Reddita jest legalny? User Agreement odpowiada, zanim zrobi to sąd
Dwie odpowiedzi na pytanie o legalność scrapingu Reddita: sądy w USA nie uznają go już za przestępstwo, a Reddit zakazuje go umową bez pisemnej zgody.


Jak sortowanie Rising na Reddicie pokazuje wątki, zanim trafią do Hot
Sortowanie Rising na Reddicie układa młode posty według ostatnich wyświetleń. Gdzie je znaleźć, jak działają endpointy .json i RSS oraz czym różni się od Hot i New.


Osiem powodów, dla których wyszukiwarka Reddita nie działa, i jak znaleźć post mimo to
Wyszukiwarka Reddita nie znajduje posta, który na pewno istnieje? Osiem przyczyn opisanych przez Reddita, od sortowania i zakresu po Safe Search i usunięcia, z rozwiązaniami.

