Zum Hauptinhalt springen
Jeden Tag senden viele Tausend Entwickler Anfragen an die X API. Um das enorme Volumen dieser Anfragen zu steuern, werden Limits für die Anzahl zulässiger Anfragen festgelegt. Diese Limits gewährleisten eine zuverlässige und skalierbare API, auf die sich unsere Entwickler-Community verlässt. Die maximale Anzahl erlaubter Anfragen basiert auf einem Zeitintervall, typischerweise über einen festgelegten Zeitraum oder ein Zeitfenster. Das gängigste Intervall beträgt fünfzehn Minuten. Ein endpoint mit einem Limit von 900 Anfragen pro 15 Minuten erlaubt beispielsweise bis zu 900 Anfragen in jedem 15‑Minuten‑Intervall. Rate Limits hängen von der Authentifizierungsmethode ab. Wenn Sie beispielsweise OAuth 1.0a User Context verwenden, hat jeder Satz von Nutzern Access Tokens sein eigenes Rate Limit pro Zeitraum. Alternativ hat Ihre App bei Verwendung eines OAuth 2.0 Bearer Token ihr eigenes separates Limit pro Zeitraum. Wenn diese Limits überschritten werden, wird ein Fehler zurückgegeben.

Inhaltsverzeichnis

X API v2 Rate Limits

Die folgende Tabelle führt die Rate Limits der einzelnen kostenpflichtigen X API‑Pläne auf. Diese Limits sind auch im Bereich „Produkte“ des Entwicklerportals verfügbar.
EndpointPro‑Limit Basic‑Limit Free‑Limit
Tweets
DELETE /2/tweets/:id50 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO NUTZER
17 Anfragen/24 Stunden
PRO NUTZER
17 Anfragen/24 Stunden
PRO APP
DELETE /2/users/:id/likes/:tweet_id50 Anfragen / 15 Min.
PRO NUTZER
100 Anfragen / 24 Std.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
DELETE /2/users/:id/retweets/:tweet_id50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
GET /2/tweets900 Anfragen/15 Min.
PRO NUTZER
450 Anfragen/15 Min.
PRO APP
15 Anfragen/15 Min.
PRO NUTZER
15 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/tweets/:id900 Anfragen/15 Min
PRO BENUTZER
450 Anfragen/15 Min
PRO APP
15 Anfragen/15 Min
PRO BENUTZER
15 Anfragen/15 Min
PRO APP
1 Anfrage/15 Min
PRO BENUTZER
1 Anfrage/15 Min
PRO APP
GET /2/tweets/:id/liking_users75 Anfragen/15 Min.
PRO NUTZER
75 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/tweets/:id/quote_tweets75 Anfragen / 15 Min.
PRO NUTZER
75 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
GET /2/tweets/:id/retweeted_by75 Anfragen/15 Min.
PRO NUTZER
75 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/tweets/counts/all300 Anfragen/15 Min.
PRO APP
GET /2/tweets/counts/recent300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO APP
GET /2/tweets/search/all1 Anfrage/Sekunde
PRO BENUTZER
1 Anfrage/Sekunde
PRO APP
GET /2/tweets/search/recent300 Requests / 15 Min.
PRO USER
450 Requests / 15 Min.
PRO APP
60 Requests / 15 Min.
PRO USER
60 Requests / 15 Min.
PRO APP
1 Request / 15 Min.
PRO USER
1 Request / 15 Min.
PRO APP
GET /2/tweets/search/stream50 Anfragen / 15 Min.
PRO APP
GET /2/tweets/search/stream/rules450 Anfragen/15 Min.
PRO APP
GET /2/users/:id/liked_tweets75 Anfragen / 15 Min.
PRO NUTZER
75 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
GET /2/users/:id/mentions300 Anfragen/15 Min.
PRO NUTZER
450 Anfragen/15 Min.
PRO APP
10 Anfragen/15 Min.
PRO NUTZER
15 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/users/:id/timelines/reverse_chronological180 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
GET /2/users/:id/tweets900 Anfragen/15 Min.
PRO NUTZER
1500 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
10 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/users/reposts_of_me75 Anfragen / 15 Min.
PRO NUTZER
75 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
POST /2/tweets100 Anfragen/15 Min.
PRO BENUTZER
10 000 Anfragen/24 Stunden
PRO APP
100 Anfragen/24 Stunden
PRO BENUTZER
1 667 Anfragen/24 Stunden
PRO APP
17 Anfragen/24 Stunden
PRO BENUTZER
17 Anfragen/24 Stunden
PRO APP
POST /2/tweets/search/stream/rules100 Anfragen/15 Min.
PRO APP
POST /2/users/:id/likes1000 Anfragen / 24 Stunden
PRO NUTZER
200 Anfragen / 24 Stunden
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
POST /2/users/:id/retweets50 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO NUTZER
PUT /2/tweets/:tweet_id/hidden50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
Nutzer
DELETE /2/users/:source_user_id/following/:target_user_id50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
DELETE /2/users/:source_user_id/muting/:target_user_id50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
GET /2/users900 Anfragen / 15 Min.
PRO NUTZER
300 Anfragen / 15 Min.
PRO APP
100 Anfragen / 24 Stunden
PRO NUTZER
500 Anfragen / 24 Stunden
PRO APP
1 Anfrage / 24 Stunden
PRO NUTZER
1 Anfrage / 24 Stunden
PRO APP
GET /2/users/:id900 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
100 Anfragen/24 Stunden
PRO NUTZER
500 Anfragen/24 Stunden
PRO APP
1 Anfrage/24 Stunden
PRO NUTZER
1 Anfrage/24 Stunden
PRO APP
GET /2/users/:id/blocking15 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO NUTZER
GET /2/users/:id/muting15 Anfragen / 15 Min.
PRO NUTZER
100 Anfragen / 24 Stunden
PRO NUTZER
1 Anfrage / 24 Stunden
PRO NUTZER
GET /2/users/by900 Anfragen / 15 Min.
PRO NUTZER
300 Anfragen / 15 Min.
PRO APP
100 Anfragen / 24 Std.
PRO NUTZER
500 Anfragen / 24 Std.
PRO APP
1 Anfrage / 24 Std.
PRO NUTZER
1 Anfrage / 24 Std.
PRO APP
GET /2/users/by/username/:username900 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
100 Anfragen/24 Std.
PRO NUTZER
500 Anfragen/24 Std.
PRO APP
3 Anfragen/15 Min.
PRO NUTZER
3 Anfragen/15 Min.
PRO APP
GET /2/users/me75 Anfragen / 15 Min.
PRO NUTZER
250 Anfragen / 24 Stunden
PRO NUTZER
25 Anfragen / 24 Stunden
PRO NUTZER
GET /2/users/search900 Anfragen / 15 Min.
PRO NUTZER
300 Anfragen / 15 Min.
PRO APP
POST /2/users/:id/following50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
POST /2/users/:id/muting50 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO NUTZER
Spaces
GET /2/spaces300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/spaces/:id300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/spaces/:id/buyers300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/spaces/:id/tweets300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/spaces/by/creator_ids300 Anfragen/15 Min
PRO BENUTZER
1 Anfrage/Sekunde
PRO APP
5 Anfragen/15 Min
PRO BENUTZER
25 Anfragen/Sekunde
PRO APP
1 Anfrage/Sekunde
PRO BENUTZER
1 Anfrage/15 Min
PRO APP
GET /2/spaces/search300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
Direct Messages
DELETE /2/dm_events/:id1500 Anfragen / 24 Stunden
PRO USER
4000 Anfragen / 24 Stunden
PRO APP
200 Anfragen / 15 Min.
PRO USER
2500 Anfragen / 24 Stunden
PRO APP
GET /2/dm_conversations/:dm_conversation_id/dm_events15 Anfragen / 15 Min.
PRO USER
1 Anfrage / 24 Stunden
PRO USER
GET /2/dm_conversations/with/:participant_id/dm_events15 Anfragen / 15 Min.
PRO BENUTZER
1 Anfrage / 24 Stunden
PRO BENUTZER
GET /2/dm_events15 Anfragen / 15 Min.
PRO BENUTZER
1 Anfrage / 24 Stunden
PRO BENUTZER
GET /2/dm_events/:id15 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 24 Stunden
PRO NUTZER
POST /2/dm_conversations15 Anfragen / 15 Min.
PRO NUTZER
1440 Anfragen / 24 Stunden
PRO APP
1 Anfrage / 24 Stunden
PRO NUTZER
1 Anfrage / 24 Stunden
PRO APP
POST /2/dm_conversations/:dm_conversation_id/messages15 Anfragen / 15 Min.
PRO NUTZER
1440 Anfragen / 24 Std.
PRO APP
1 Anfrage / 24 Std.
PRO NUTZER
1 Anfrage / 24 Std.
PRO APP
POST /2/dm_conversations/with/:participant_id/messages1440 Anfragen/24 Stunden
PRO NUTZER
1440 Anfragen/24 Stunden
PRO APP
1 Anfrage/24 Stunden
PRO NUTZER
1 Anfrage/24 Stunden
PRO APP
Lists
DELETE /2/lists/:id300 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
DELETE /2/lists/:id/members/:user_id300 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
DELETE /2/users/:id/followed_lists/:list_id50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
DELETE /2/users/:id/pinned_lists/:list_id50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
GET /2/lists/:id75 Anfragen / 15 Min.
PRO NUTZER
75 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
GET /2/lists/:id/members900 Anfragen/15 Min.
PRO NUTZER
900 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/lists/:id/tweets900 Anfragen / 15 Min
PRO NUTZER
900 Anfragen / 15 Min
PRO APP
5 Anfragen / 15 Min
PRO NUTZER
25 Anfragen / 15 Min
PRO APP
GET /2/users/:id/list_memberships75 Anfragen/15 Min.
PRO NUTZER
75 Anfragen/15 Min.
PRO APP
5 Anfragen/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP
GET /2/users/:id/owned_lists15 Anfragen / 15 Min.
PRO NUTZER
15 Anfragen / 15 Min.
PRO APP
100 Anfragen / 24 Std.
PRO NUTZER
500 Anfragen / 24 Std.
PRO APP
1 Anfrage / 24 Std.
PRO NUTZER
1 Anfrage / 24 Std.
PRO APP
GET /2/users/:id/pinned_lists15 Anfragen / 15 Min.
PRO NUTZER
15 Anfragen / 15 Min.
PRO APP
100 Anfragen / 24 Stunden
PRO NUTZER
500 Anfragen / 24 Stunden
PRO APP
1 Anfrage / 24 Stunden
PRO NUTZER
1 Anfrage / 24 Stunden
PRO APP
POST /2/lists300 Anfragen / 15 Min.
PRO BENUTZER
100 Anfragen / 24 Stunden
PRO BENUTZER
1 Anfrage / 24 Stunden
PRO BENUTZER
POST /2/lists/:id/members300 Anfragen / 15 Min.
PRO BENUTZER
5 Anfragen / 15 Min.
PRO BENUTZER
1 Anfrage / 15 Min.
PRO BENUTZER
POST /2/users/:id/followed_lists50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
POST /2/users/:id/pinned_lists50 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
PUT /2/lists/:id300 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
Lesezeichen
DELETE /2/users/:id/bookmarks/:tweet_id50 Anfragen/15 Min.
PRO NUTZER
5 Anfragen/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO NUTZER
GET /2/users/:id/bookmarks180 Anfragen / 15 Min.
PRO NUTZER
10 Anfragen / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO NUTZER
GET /2/users/:id/bookmarks/folders50 Anfragen / 15 Min.
PRO NUTZER
50 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
GET /2/users/:id/bookmarks/folders/:folder_id50 Anfragen / 15 Min.
PRO NUTZER
50 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO NUTZER
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
POST /2/users/:id/bookmarks50 Anfragen / 15 Min
PRO NUTZER
5 Anfragen / 15 Min
PRO NUTZER
1 Anfrage / 15 Min
PRO NUTZER
Compliance
GET /2/compliance/jobs150 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO APP
GET /2/compliance/jobs/:job_id150 Anfragen / 15 Min.
PRO APP
5 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO APP
POST /2/compliance/jobs150 Anfragen / 15 Min.
PRO APP
15 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO APP
Verwendung
GET /2/usage/tweets50 Anfragen/15 Min
PRO APP
50 Anfragen/15 Min
PRO APP
1 Anfrage/15 Min
PRO APP
Trends
GET /2/trends/by/woeid/:id75 Anfragen/15 Min.
PRO APP
15 Anfragen/15 Min.
PRO APP
GET /2/users/personalized_trends10 Anfragen/15 Min.
PRO NUTZER
200 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
20 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/24 Std.
PRO APP
Communities
GET /2/communities/:id300 Anfragen / 15 Min.
PRO NUTZER
300 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
25 Anfragen / 15 Min.
PRO APP
1 Anfrage / 15 Min.
PRO NUTZER
1 Anfrage / 15 Min.
PRO APP
GET /2/communities/search300 Anfragen/15 Min.
PRO NUTZER
300 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
25 Anfragen/15 Min.
PRO APP
1 Anfrage/15 Min.
PRO NUTZER
1 Anfrage/15 Min.
PRO APP

Rate Limits und Authentifizierungsmethode

Rate Limits gelten sowohl auf Ebene der Developer-App als auch auf Ebene des Benutzer-access token:
  • OAuth 2.0 Bearer Token: App-Rate Limit Mit dieser Methode können Sie eine bestimmte Anzahl von Anfragen im Namen Ihrer Developer-App stellen. Bei Verwendung dieser Authentifizierungsmethode werden die Limits durch die mit einem Bearer Token ausgeführten Anfragen bestimmt.
    • Beispiel: Bei einem Limit von 450 Anfragen pro 15-Minuten-Intervall können Sie innerhalb dieses Intervalls 450 Anfragen im Namen Ihrer App stellen.
  • OAuth 1.0a User Context: Nutzer-Rate Limit Diese Methode ermöglicht Anfragen im Namen eines X-Nutzers, der durch den Benutzer-access token identifiziert wird. Wenn Sie beispielsweise private metrics von Posts abrufen, authentifizieren Sie sich mit Benutzer-Access Tokens für diesen Nutzer, die über den 3-legged OAuth-Flow generiert wurden.
    • Beispiel: Bei einem Limit von 900 Anfragen pro 15 Minuten und pro Nutzer können Sie in diesem Zeitraum bis zu 900 Anfragen pro Nutzer stellen.

HTTP-Header und Antwortcodes

Verwenden Sie HTTP-Header, um anhand der zuletzt gesendeten Anfrage nachzuvollziehen, wo Ihre Anwendung innerhalb eines vorgegebenen Rate Limits steht.
  • x-rate-limit-limit: Rate-Limit-Obergrenze für den endpoint
  • x-rate-limit-remaining: verbleibende Anfragen im 15‑Minuten‑Fenster
  • x-rate-limit-reset: verbleibende Zeit bis zum Zurücksetzen des Rate Limits (in UTC-Epochensekunden)

Fehlerantworten

Wenn eine Anwendung das Rate Limit für ein endpoint überschreitet, gibt die API eine HTTP 429 „Too Many Requests“-Antwort mit der folgenden Fehlermeldung im Antworttext zurück:
{ "errors": [ { "code": 88, "message": "Rate Limit überschritten" } ] }

Wiederherstellung nach einem Rate Limit

Wenn diese Rate Limits überschritten werden, gibt das endpoint einen 429-Fehler „Too many requests“ zurück. Wie unten erläutert, empfiehlt es sich bei Rate-Limit-Fehlern, die HTTP-Header zu prüfen, die angeben, wann das Limit zurückgesetzt wird, und Anfragen bis dahin zu pausieren.
Tritt ein „Too many requests“- oder Rate-Limiting-Fehler auf, sollte die Anfragerate reduziert werden. Bei einem Rate-Limit-Fehler kann der HTTP-Header x-rate-limit-reset: geprüft werden, um zu erfahren, wann das Rate Limiting zurückgesetzt wird

. Ein weiteres gängiges Muster ist das exponentielle Backoff, bei dem die Zeit zwischen den Anfragen zunächst klein ist (zum Beispiel ein paar Sekunden) und vor jedem erneuten Versuch verdoppelt wird. Dies wird fortgesetzt, bis eine Anfrage erfolgreich ist oder eine angemessene maximale Zeit zwischen Anfragen erreicht ist (zum Beispiel ein paar Minuten).

Idealerweise ist der Client clientseitig über bestehende Rate Limits im Bilde und kann Anfragen pausieren, bis das aktuell überschrittene Zeitfenster abläuft. Wenn Sie ein 15-Minuten-Limit überschreiten, ist es sinnvoll, eine oder zwei Minuten zu warten, bevor Sie es erneut versuchen.

Beachten Sie, dass über diese Limits für die Anzahl der Anfragen hinaus die Zugriffsstufe Standard Basic bis zu 500.000 Posts pro Monat aus den recent search- und Filtered stream-endpoints bereitstellt. Wenn Sie das monatliche Limit für die Anzahl der Posts überschritten haben, ist es für Ihre App sinnvoller, eine Benachrichtigung auszulösen, den Tag der Anmeldung im Monat zu kennen und Anfragen bis zu diesem Tag zurückzustellen.

Tipps zur Vermeidung von Rate Limits

Die folgenden Tipps sollen Ihnen helfen, defensiv zu programmieren und die Wahrscheinlichkeit zu verringern, auf ein Rate Limit zu stoßen. Einige Funktionen, die Sie in Ihrer Anwendung anbieten möchten, sind angesichts von Rate Limits schlicht nicht möglich, insbesondere was die Aktualität der Ergebnisse betrifft. Wenn Echtzeitinformationen ein Ziel Ihrer Anwendung sind, sehen Sie sich die filtered- und sampled-Stream-endpoints an.

Caching

Speichern Sie API-Antworten, wenn eine häufige Nutzung zu erwarten ist. Anstatt die API bei jedem Seitenaufruf erneut aufzurufen, zwischenspeichern Sie die Antwort lokal.

Aktive Nutzer priorisieren

Wenn Ihre Website viele X-Nutzer verfolgt (z. B. indem sie deren aktuellen Status oder Statistiken zur Nutzung von X abruft), sollten Sie erwägen, nur data für Nutzer anzufordern, die sich kürzlich auf Ihrer Website angemeldet haben.

An die Suchergebnisse anpassen

Wenn Ihre Anwendung ein großes Volumen an Suchbegriffen überwacht, rufen Sie die query für Suchen ohne Ergebnisse seltener ab als für solche mit Ergebnissen. Durch ein Backoff bleiben Sie bei beliebten Abfragen aktuell, ohne Rechenzyklen für Abfragen zu verschwenden, die sich nur sehr selten ändern. Alternativ können Sie das Filtered stream endpoint verwenden und mit Ihren Suchabfragen filtern.

Denylist

Wenn eine Anwendung die Rate Limits missachtet, wird sie auf die Denylist gesetzt. Apps auf der Denylist erhalten keine Antwort von der X API. Wenn Sie oder Ihre Anwendung auf die Denylist gesetzt wurden und Sie glauben, dass ein Fehler vorliegt, können Sie unsere Platform Support forms nutzen, um Unterstützung anzufordern. Bitte fügen Sie folgende Informationen bei:
  1. Erklären Sie, warum Sie glauben, dass Ihre Anwendung auf die Denylist gesetzt wurde.
  2. Falls Sie nicht mehr von Rate Limits betroffen sind, beschreiben Sie im Detail, wie Sie das Problem behoben haben.
I