Inhaltsverzeichnis
- X API v2 Rate Limits
- X API Enterprise Rate Limits
- Rate Limits und Authentifizierungsmethode
- HTTP-Header und Antwortcodes
- Umgang mit Rate Limits
- Tipps zur Vermeidung von Rate Limits
X API v2 Rate Limits
Endpoint | Pro‑Limit | Basic‑Limit | Free‑Limit |
---|---|---|---|
Tweets | |||
DELETE /2/tweets/:id | 50 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_id | 50 Anfragen / 15 Min. PRO NUTZER | 100 Anfragen / 24 Std. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
DELETE /2/users/:id/retweets/:tweet_id | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
GET /2/tweets | 900 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/:id | 900 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_users | 75 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_tweets | 75 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_by | 75 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/all | 300 Anfragen/15 Min. PRO APP | ||
GET /2/tweets/counts/recent | 300 Anfragen/15 Min. PRO APP | 5 Anfragen/15 Min. PRO APP | 1 Anfrage/15 Min. PRO APP |
GET /2/tweets/search/all | 1 Anfrage/Sekunde PRO BENUTZER 1 Anfrage/Sekunde PRO APP | ||
GET /2/tweets/search/recent | 300 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/stream | 50 Anfragen / 15 Min. PRO APP | ||
GET /2/tweets/search/stream/rules | 450 Anfragen/15 Min. PRO APP | ||
GET /2/users/:id/liked_tweets | 75 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/mentions | 300 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_chronological | 180 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
GET /2/users/:id/tweets | 900 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_me | 75 Anfragen / 15 Min. PRO NUTZER | 75 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
POST /2/tweets | 100 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/rules | 100 Anfragen/15 Min. PRO APP | ||
POST /2/users/:id/likes | 1000 Anfragen / 24 Stunden PRO NUTZER | 200 Anfragen / 24 Stunden PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
POST /2/users/:id/retweets | 50 Anfragen/15 Min. PRO NUTZER | 5 Anfragen/15 Min. PRO NUTZER | 1 Anfrage/15 Min. PRO NUTZER |
PUT /2/tweets/:tweet_id/hidden | 50 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_id | 50 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_id | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
GET /2/users | 900 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 | 900 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/blocking | 15 Anfragen/15 Min. PRO NUTZER | 5 Anfragen/15 Min. PRO NUTZER | 1 Anfrage/15 Min. PRO NUTZER |
GET /2/users/:id/muting | 15 Anfragen / 15 Min. PRO NUTZER | 100 Anfragen / 24 Stunden PRO NUTZER | 1 Anfrage / 24 Stunden PRO NUTZER |
GET /2/users/by | 900 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/:username | 900 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/me | 75 Anfragen / 15 Min. PRO NUTZER | 250 Anfragen / 24 Stunden PRO NUTZER | 25 Anfragen / 24 Stunden PRO NUTZER |
GET /2/users/search | 900 Anfragen / 15 Min. PRO NUTZER 300 Anfragen / 15 Min. PRO APP | ||
POST /2/users/:id/following | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
POST /2/users/:id/muting | 50 Anfragen/15 Min. PRO NUTZER | 5 Anfragen/15 Min. PRO NUTZER | 1 Anfrage/15 Min. PRO NUTZER |
Spaces | |||
GET /2/spaces | 300 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 | 300 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/buyers | 300 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/tweets | 300 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_ids | 300 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/search | 300 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/:id | 1500 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_events | 15 Anfragen / 15 Min. PRO USER | 1 Anfrage / 24 Stunden PRO USER | |
GET /2/dm_conversations/with/:participant_id/dm_events | 15 Anfragen / 15 Min. PRO BENUTZER | 1 Anfrage / 24 Stunden PRO BENUTZER | |
GET /2/dm_events | 15 Anfragen / 15 Min. PRO BENUTZER | 1 Anfrage / 24 Stunden PRO BENUTZER | |
GET /2/dm_events/:id | 15 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 24 Stunden PRO NUTZER | |
POST /2/dm_conversations | 15 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/messages | 15 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/messages | 1440 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/:id | 300 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
DELETE /2/lists/:id/members/:user_id | 300 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
DELETE /2/users/:id/followed_lists/:list_id | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
DELETE /2/users/:id/pinned_lists/:list_id | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
GET /2/lists/:id | 75 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/members | 900 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/tweets | 900 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_memberships | 75 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_lists | 15 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_lists | 15 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/lists | 300 Anfragen / 15 Min. PRO BENUTZER | 100 Anfragen / 24 Stunden PRO BENUTZER | 1 Anfrage / 24 Stunden PRO BENUTZER |
POST /2/lists/:id/members | 300 Anfragen / 15 Min. PRO BENUTZER | 5 Anfragen / 15 Min. PRO BENUTZER | 1 Anfrage / 15 Min. PRO BENUTZER |
POST /2/users/:id/followed_lists | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
POST /2/users/:id/pinned_lists | 50 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
PUT /2/lists/:id | 300 Anfragen / 15 Min. PRO NUTZER | 5 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
Lesezeichen | |||
DELETE /2/users/:id/bookmarks/:tweet_id | 50 Anfragen/15 Min. PRO NUTZER | 5 Anfragen/15 Min. PRO NUTZER | 1 Anfrage/15 Min. PRO NUTZER |
GET /2/users/:id/bookmarks | 180 Anfragen / 15 Min. PRO NUTZER | 10 Anfragen / 15 Min. PRO NUTZER | 1 Anfrage / 15 Min. PRO NUTZER |
GET /2/users/:id/bookmarks/folders | 50 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_id | 50 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/bookmarks | 50 Anfragen / 15 Min PRO NUTZER | 5 Anfragen / 15 Min PRO NUTZER | 1 Anfrage / 15 Min PRO NUTZER |
Compliance | |||
GET /2/compliance/jobs | 150 Anfragen / 15 Min. PRO APP | 5 Anfragen / 15 Min. PRO APP | 1 Anfrage / 15 Min. PRO APP |
GET /2/compliance/jobs/:job_id | 150 Anfragen / 15 Min. PRO APP | 5 Anfragen / 15 Min. PRO APP | 1 Anfrage / 15 Min. PRO APP |
POST /2/compliance/jobs | 150 Anfragen / 15 Min. PRO APP | 15 Anfragen / 15 Min. PRO APP | 1 Anfrage / 15 Min. PRO APP |
Verwendung | |||
GET /2/usage/tweets | 50 Anfragen/15 Min PRO APP | 50 Anfragen/15 Min PRO APP | 1 Anfrage/15 Min PRO APP |
Trends | |||
GET /2/trends/by/woeid/:id | 75 Anfragen/15 Min. PRO APP | 15 Anfragen/15 Min. PRO APP | |
GET /2/users/personalized_trends | 10 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/:id | 300 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/search | 300 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
-
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
x-rate-limit-limit
: Rate-Limit-Obergrenze für den endpointx-rate-limit-remaining
: verbleibende Anfragen im 15‑Minuten‑Fensterx-rate-limit-reset
: verbleibende Zeit bis zum Zurücksetzen des Rate Limits (in UTC-Epochensekunden)
Fehlerantworten
Wiederherstellung nach einem Rate Limit
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
Caching
Aktive Nutzer priorisieren
An die Suchergebnisse anpassen
Denylist
- Erklären Sie, warum Sie glauben, dass Ihre Anwendung auf die Denylist gesetzt wurde.
- Falls Sie nicht mehr von Rate Limits betroffen sind, beschreiben Sie im Detail, wie Sie das Problem behoben haben.