glossary

X przestał publikować limity żądań API Twittera według planów

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
X przestał publikować limity żądań API Twittera według planówX przestał publikować limity żądań API Twittera według planów

TL;DR

8 min czytania

X publikuje jedną tabelę limitów żądań dla API v2, uporządkowaną według endpointów i podzieloną na kolumnę dla aplikacji i kolumnę dla użytkownika, z oknami 15-minutowymi lub 24-godzinnymi. Recent search pozwala na 450 żądań na 15 minut na aplikację i 300 na użytkownika; full-archive search na 1 na sekundę i 300 na 15 minut. Zamiast czterech poziomów komercyjnych są teraz dwa: płatność za użycie, z limitem 3 mln odczytów postów miesięcznie, oraz Enterprise. Sprawdzono 12 września 2026 roku.

Jakie są limity żądań API Twittera w 2026 roku?

W obecnej dokumentacji X nic nie wiąże limitów żądań API Twittera z planem. Aktualne tabele są uporządkowane według endpointów i podzielone na dwie kolumny: jedną z limitami na aplikację, obowiązującymi przy uwierzytelnianiu tokenem bearer, i drugą z limitami na użytkownika, obowiązującymi przy tokenach użytkownika OAuth 1.0a lub OAuth 2.0. Każda liczba poniżej pochodzi z docs.x.com/x-api/fundamentals/rate-limits, odczytanego 12 września 2026 roku.

Okna trwają 15 minut, chyba że wpis stanowi inaczej. To endpointy, z których naprawdę korzysta narzędzie do social listeningu lub monitoringu.

MetodaEndpointNa aplikacjęNa użytkownika
GET/2/tweets/search/recent450/15min300/15min
GET/2/tweets/search/all1/sec, 300/15min1/sec
GET/2/tweets/counts/recent300/15minniedostępne
GET/2/tweets/counts/all300/15minniedostępne
GET/2/tweets3 500/15min5 000/15min
GET/2/tweets/:id450/15min900/15min
GET/2/tweets/search/stream50/15minniedostępne
POST/2/tweets/search/stream/rules100/15minniedostępne
GET/2/tweets/search/stream/rules450/15minniedostępne
GET/2/users/:id/tweets10 000/15min900/15min
GET/2/users/:id/mentions450/15min300/15min
GET/2/users/by/username/:username300/15min900/15min
POST/2/tweets10 000/24hrs100/15min
GET/2/usage/tweets50/15minniedostępne
GET/2/tweets/sample10/stream100/15minniedostępne

Dwa wpisy w tej tabeli zasługują na uwagę. Recent search daje aplikacji 450 żądań, a użytkownikowi tylko 300, więc token bearer samej aplikacji jest przy monitoringu mocniejszym poświadczeniem. Full-archive search podlega limitowi na sekundę w takim samym stopniu jak limitowi na okno, więc zadanie uzupełniające dane historyczne potrzebuje przerwy między wywołaniami, a nie serii i czekania.

Których planów dotyczą limity żądań API Twittera?

X ma dziś dwa poziomy komercyjne, płatność za użycie i Enterprise, a plany subskrypcyjne Free, Basic i Pro, które wciąż cytują starsze przewodniki, już nie istnieją. Dziennik zmian pozwala datować to przejście. X ogłosił pilotaż płatności za użycie 20 października 2025 roku i uruchomił ten cennik 6 lutego 2026 roku, gdy Basic i Pro były jeszcze dostępne, a następnie przeniósł subskrybentów Basic po 1 czerwca 2026 roku i subskrybentów Pro po 1 września 2026 roku. Powyższe tabele limitów nie mają w ogóle kolumny z planami i to jest szczera odpowiedź na pytanie "jakie limity ma Basic". Basica już nie ma.

Tam, gdzie X nadal rozróżnia poziomy, liczby wyglądają tak.

LimitPłatność za użycieEnterprise
Miesięczny limit odczytów postów3 mln odczytów na cykl rozliczeniowyIndywidualny lub bez limitu
Reguły filtered stream na projekt1 00025 000+
Długość reguły filtered stream1 024 znaki2 048 znaków
Połączenia filtered stream1Wiele
Długość zapytania recent search512 znaków4 096 znaków
Długość zapytania full-archive search1 024 znaki4 096 znaków
Limity żądań na endpointStandardowe tabeleIndywidualne, określone w umowie
Z czterech poziomów do dwóch
1
Przed 2026 rokiem. Dostęp i limity żądań wyznaczały plany Free, Basic, Pro i Enterprise.
2
20 października 2025. X ogłasza pilotaż płatności za użycie.
3
6 lutego 2026. Startuje cennik za użycie, a Basic i Pro zostaną przeniesione później w 2026 roku.
4
Dziś. Zostały dwa poziomy komercyjne: płatność za użycie z limitem 3 mln odczytów postów miesięcznie oraz Enterprise.
Według dziennika zmian X system planów skurczył się z czterech poziomów do dwóch w cztery miesiące.

Gdzie X przeczy sam sobie w tych liczbach?

Trzy aktualne strony w docs.x.com są ze sobą sprzeczne, a rozbieżności nie są kosmetyczne.

Pierwsza dotyczy liczby reguł filtered stream. Strona wprowadzająca do filtered stream podaje dla Enterprise "25 000+" reguł na projekt. Strona cennika Enterprise, opisująca ten sam produkt, podaje "5,000+ rules". Obie strony działały 12 września 2026 roku i żadna nie odsyła do drugiej jako do sprostowania.

Druga dotyczy długości zapytania przy zliczaniu postów. Tabela limitów podaje przy /2/tweets/counts/all adnotację "1024 query length". Strona o budowaniu zapytań zliczających mówi: "Your query can be 512 characters long for pay-per-use customers, or up to 4,096 characters for Enterprise customers", obejmując jedną liczbą oba endpointy zliczające. Zapytanie o długości 1 024 znaków do /2/tweets/counts/all mieści się więc w limicie jednej strony, a przekracza limit drugiej.

Trzecia to odwołanie donikąd. Oba narzędzia do budowania zapytań wyszukiwania i narzędzie do budowania reguł filtered stream informują, że limity zależą od poziomu dostępu, i po szczegóły odsyłają do /x-api/getting-started/about-x-api. Ta strona nie ma już sekcji o poziomach dostępu. Zawiera możliwości, wersje API, zasoby i cennik za użycie, ale nic, co nazywałoby jakiś plan. Strona docs.x.com/fundamentals/rate-limits ma opis "Understand X API rate limits across access tiers and endpoints", a potem nie wymienia żadnych planów, tylko linkuje do tabeli endpointów.

Wniosek dla każdego, kto planuje budżet projektu: traktuj tabelę endpointów jako dokument obowiązujący, a strony opisowe jako nieaktualne.

Jak czytać nagłówki limitów żądań?

X zwraca w każdej odpowiedzi trzy nagłówki i to one są jedynym źródłem prawdy w czasie rzeczywistym.

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

x-rate-limit-limit to górna granica bieżącego okna, x-rate-limit-remaining to pozostała pula, a x-rate-limit-reset to uniksowy znacznik czasu, w którym okno się odnawia. Po przekroczeniu granicy dostajesz 429 z taką treścią:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

Błąd code: 88 przetrwał każdą przebudowę tego API od wersji v1.1, więc warto dopasowywać go jawnie, a nie opierać się wyłącznie na kodzie statusu. X sam zaleca odczytanie x-rate-limit-reset, odczekanie do tego momentu, a potem zastosowanie wykładniczego wycofania.

Osoba sprawdzająca nocą powiadomienie w telefonie, co przywodzi na myśl różnicę między limitem żądań a rachunkiem.

Czy limity żądań to to samo co rachunek?

Nie, i X mówi o tym wprost: limity żądań kontrolują częstotliwość zapytań dla stabilności systemu, a rozliczenie za użycie dotyczy pobranych danych. Możesz mieścić się w każdym limicie i nadal wydawać, a możesz też trafić na limit, nie wydając nic ponad to.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Odczyty są naliczane za zwrócony zasób, a nie za żądanie. Odczyt posta kosztuje 0,005 $, a odczyt użytkownika 0,010 $. Zasoby są deduplikowane w ramach 24-godzinnego okna UTC, więc dwukrotne pobranie tego samego posta w ciągu dnia jest liczone raz, przy czym X nazywa tę deduplikację miękką gwarancją, a nie obietnicą. Plan z płatnością za użycie ma limit 3 mln odczytów postów na miesięczny cykl rozliczeniowy, bez względu na to, jak spokojnie rozłożysz żądania. Pełny obraz kosztów, łącznie z zapisami, znajdziesz w tekście o cenniku API X.

Który limit naprawdę zatrzymuje projekt monitoringu?

Miesięczny limit odczytów postów, a nie limit żądań na okno. Recent search przy 450 żądaniach na 15 minut i 100 wynikach na żądanie to na papierze 45 000 postów na okno, co wyczerpałoby pulę 3 mln postów w niecałą dobę ciągłego odpytywania. Limit żądań jest hojny; to limit zasobów wyznacza budżet.

To zmienia kształt dobrego zapytania. Wąskie reguły zwracające niewiele dopasowań kosztują mało, a szeroka reguła pasująca do popularnego słowa spala pulę, gdy śpisz. Filtered stream jest tańszym narzędziem do ciągłego pokrycia, bo dostarcza tylko to, co pasuje do twoich reguł, a samo ich utrzymywanie nic nie kosztuje. Pisanie takich reguł to ta sama umiejętność co pisanie dobrego zapytania wyszukiwania, którą omawiamy w materiale o zaawansowanych operatorach wyszukiwania X.

Druga połowa rachunku to fakt, że X jest tylko jedną siecią. Pytanie zakupowe zadane na X zwykle pada też na Reddicie i Hacker News, a te platformy rozliczają dostęp inaczej, co pokazuje porównanie limitów żądań API Reddita. Zespoły, które zaczęły od API X, a potem wyceniły lukę w pokryciu, zwykle kończą na social listeningu w kilku sieciach, zamiast płacić za poszerzanie jednej.

Najczęściej zadawane pytania

Jaki jest limit żądań API wyszukiwania X?

Recent search pod /2/tweets/search/recent pozwala na 450 żądań na 15 minut z tokenem bearer aplikacji i 300 na 15 minut z tokenem użytkownika, zwracając domyślnie 10 wyników, a maksymalnie 100. Full-archive search pod /2/tweets/search/all pozwala na 1 żądanie na sekundę i 300 na 15 minut na aplikację, zwracając domyślnie 10 wyników, a maksymalnie 500.

Czy X nadal ma plan Free?

Nie jako udokumentowany produkt. X uruchomił cennik za użycie 6 lutego 2026 roku, a obecna dokumentacja uzyskiwania dostępu prowadzi przez rejestrację, utworzenie aplikacji i zapisanie danych uwierzytelniających, nie wymieniając żadnego planu. Słowo "Free" przetrwało tylko we wpisach dziennika zmian, w tym w notatce z 22 sierpnia 2025 roku, która usunęła POST /2/users/:id/likes i POST /2/users/:id/following z planu Free.

Co oznacza HTTP 429 w API X?

Oznacza przekroczenie limitu żądań dla danego endpointu w bieżącym oknie. Treść odpowiedzi zawiera code: 88 i komunikat "Rate limit exceeded". Odczytaj nagłówek x-rate-limit-reset z uniksowym znacznikiem czasu odnowienia okna i nie ponawiaj żądania wcześniej.

Czy limity żądań liczone są na aplikację, czy na użytkownika?

Na jedno i drugie, a to, który obowiązuje, zależy od sposobu uwierzytelnienia. Żądania z tokenem bearer liczą się do limitu aplikacji, a żądania z tokenem użytkownika OAuth 1.0a lub OAuth 2.0 do limitu danego użytkownika. Kilka endpointów publikuje tylko jedną z tych kolumn, co oznacza, że drugi tryb uwierzytelniania nie jest tam w ogóle dostępny.

Szafy serwerowe z migającymi diodami stanu symbolizują ciągłe połączenie, które utrzymuje filtered stream.

Ile reguł filtered stream mogę uruchomić?

Projekt z płatnością za użycie dostaje 1 000 reguł o długości do 1 024 znaków każda, przez jedno połączenie, z dostarczaniem ograniczonym do 250 postów na sekundę. Enterprise podnosi długość reguły do 2 048 znaków i pozwala na wiele połączeń. Liczba reguł w Enterprise to właśnie punkt, w którym strony X są sprzeczne: 25 000+ we wprowadzeniu do filtered stream i 5 000+ na stronie cennika Enterprise.

Czy limity żądań dotyczą także endpointu użycia?

Tak. GET /2/usage/tweets, endpoint raportujący twoje własne zużycie postów, ma limit 50 żądań na 15 minut na aplikację i nie oferuje limitu na użytkownika. Sprawdzanie własnych wydatków jest tanie, ale też podlega limitom, więc odczytuj je według harmonogramu, a nie przed każdym wywołaniem.

Ile API X pobiera za odczyt posta?

Odczyt posta kosztuje 0,005 $, a odczyt użytkownika 0,010 $, naliczane za zwrócony zasób, a nie za żądanie. X deduplikuje zasoby w ramach 24-godzinnego okna UTC, więc dwukrotne pobranie tego samego posta w ciągu dnia liczy się raz, choć X nazywa tę deduplikację miękką gwarancją, a nie obietnicą. Plan z płatnością za użycie ogranicza łączną liczbę odczytów postów do 3 mln na cykl rozliczeniowy, niezależnie od ich tempa.

Kiedy X wycofał plany API Basic i Pro?

X uruchomił cennik za użycie 6 lutego 2026 roku, gdy Basic i Pro były jeszcze dostępne, a potem wycofał oba. Subskrybenci Basic zostali przeniesieni po 1 czerwca 2026 roku, a subskrybenci Pro po 1 września 2026 roku, co zostawiło Enterprise i płatność za użycie. Starsze przewodniki, które wciąż podają limity Basic lub Pro, opisują strukturę cen, która już nie istnieje.

Dlaczego na niektórych endpointach limit na użytkownika jest wyższy niż na aplikację?

Nie ma jednej reguły. Na /2/tweets token bearer aplikacji dostaje 3 500 żądań na 15 minut, a token użytkownika 5 000, a /2/tweets/:id działa podobnie: 450 wobec 900. Recent search działa odwrotnie, 450 na aplikację wobec 300 na użytkownika, więc mocniejsze poświadczenie zależy od wywoływanego endpointu, a nie od stałej hierarchii między uwierzytelnianiem aplikacji i użytkownika.

Jaki jest najtańszy sposób na ciągły monitoring X?

Filtered stream, a nie odpytywanie wyszukiwania. Recent search przy 450 żądaniach na 15 minut i 100 wynikach na wywołanie może na papierze zwrócić 45 000 postów na okno, co wystarczy, by spalić miesięczną pulę 3 mln postów w niecałą dobę ciągłego odpytywania. Filtered stream dostarcza tylko to, co pasuje do twoich reguł, a ich utrzymywanie nic nie kosztuje, więc dobrze określony zestaw reguł obejmuje ten sam obszar za ułamek odczytów.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

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

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