TikTok Events API Rate Limit: 1.000 Anfragen/s (2026)
Zuletzt geprüft am · Quellen am Ende dieser Seite
TikTok begrenzt jeden Endpoint separat, gemessen in einem gleitenden Fenster von einer Minute. Der Direct-Post-Endpoint erlaubt 6 Anfragen pro Minute und User-Access-Token, Query Creator Info erlaubt 20, Get Post Status 30, und die Lese-Endpoints für Nutzer und Videos (/v2/user/info/, /v2/video/query/, /v2/video/list/) jeweils 600. Wer drüber liegt, bekommt HTTP 429 mit dem Fehlercode rate_limit_exceeded. Die Events API ist ein eigenes System auf einem eigenen Host: 1.000 Anfragen pro Sekunde, gleich auf jeder Anwendungsstufe, mit dem Code 40100 bei Drosselung.
Wie hoch ist das Rate Limit für jeden TikTok-API-Endpoint?
Die Limits werden pro Endpoint festgelegt und durchgesetzt, nicht als ein gemeinsames Budget. Ist Direct Post ausgeschöpft, wird Get Post Status nicht langsamer, und umgekehrt.
| Endpoint | Limit | Was das in der Praxis heißt |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 requests / minute per user access token | Das entscheidende Limit für alle, die auf mehreren Konten posten. Es gilt pro Token, also pro verbundenem Konto – zehn Konten teilen sich keine sechs Anfragen, jedes hat seine eigenen sechs. |
| Query Creator Info | 20 requests / minute per user access token | Wird vor jedem Post aufgerufen, weil die Posting-Oberfläche die echten Privatsphäre-Optionen des Creators anzeigen muss. Deshalb kostet ein Veröffentlichungsablauf mindestens zwei Aufrufe, nicht einen. |
| Get Post Status | 30 requests / minute per user access token | Polling. Dreißig pro Minute klingt großzügig, bis du zehn Konten alle zwei Sekunden abfragst – das sind 300. |
| /v2/user/info/ | 600 requests / minute | Profil-Abfragen. |
| /v2/video/query/ | 600 requests / minute | Kennzahlen für bestimmte Videos. |
| /v2/video/list/ | 600 requests / minute | Seitenweise Auflistung der Videos eines Creators. |
Wie wird das Fenster berechnet, und was passiert, wenn du es überschreitest?
Gerechnet wird mit einem gleitenden Fenster von einer Minute, nicht mit einer festen Uhrminute. Ein Schub von sechs Posts um 10:00:59 wird um 10:01:00 nicht zurückgesetzt – er zählt weiter bis 10:01:59.
Über der Schwelle antwortet die API mit HTTP 429 und dem Fehlercode rate_limit_exceeded. Laut TikTok lassen sich die Limits auf Anfrage über die Support-Seite erhöhen, geprüft wird von Fall zu Fall.
Die praktische Folge für alle, die auf mehreren Konten veröffentlichen: Ein neuer Versuch nach einem 429 muss zurückweichen, nicht wiederholen. Ein sofortiger Retry verlängert genau das Fenster, aus dem er raus will.
Wie hoch ist das Rate Limit der TikTok Events API, in Anfragen pro Sekunde?
Tausend pro Sekunde, und zwar für jede Entwickleranwendung dieselbe Zahl – die einzige Stelle, an der TikTok dich nicht um mehr bitten lässt.
Das ist eine andere API als alle Endpoints oben, und genau darüber stolpern viele. Die Content-Posting-Endpoints liegen auf developers.tiktok.com und werden pro Minute und User-Access-Token gezählt. Die Events API gehört zur Marketing API auf business-api.tiktok.com und wird in QPS, QPM und QPD gegen deine Entwickleranwendung gezählt. Zwei Hosts, zwei Systeme, zwei Fehlercodes: Die Marketing API antwortet mit "code": 40100, wo die Entwickler-API HTTP 429 zurückgibt.
Deine Anwendung steht außerdem auf einer von vier globalen Stufen – Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, und jede App startet bei Basic. Die Events-Endpoints sind von dieser Leiter ausdrücklich ausgenommen: Laut TikTok musst du für die Events API keine Änderung der Rate-Limit-Stufe beantragen, weil das Limit auf allen Stufen gleich ist. Die 1.000 QPS unten bekommt also schon eine brandneue App am ersten Tag.
| Endpoint | Limit | Was das in der Praxis heißt |
|---|---|---|
| Web Events (/pixel/track/) and /pixel/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | Web-Conversions aus dem Browser und serverseitig. Der Tageswert ist exakt 1.000 × 86.400, das Sekundenlimit ist also das einzige, das du realistisch erreichen kannst. |
| App Events (/app/track/) and /app/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | Conversions aus mobilen Apps. |
| Offline Events (/offline/track/) and /offline/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | Conversions aus dem Laden und dem CRM, nachträglich gesendet. |
| /event/track/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | Der Endpoint der Events API 2.0. |
| Streaming API | 10,000 / second at Basic, up to 50,000 at Ultimate | Das einzige Limit auf der Events-Seite, das der Stufenleiter folgt. |
Warum dauert das Posten auf zehn Konten nicht zehnmal so lange?
Weil jedes Limit oben an ein User-Access-Token gebunden ist, und ein Token ist ein verbundenes Konto. Zehn Konten sind zehn unabhängige Töpfe mit je sechs Posts pro Minute.
Was sich tatsächlich hintereinanderreiht, ist deine eigene Infrastruktur: Eine Videodatei zehnmal hochgeladen sind zehn Übertragungen. Das Limit, das zuerst greift, ist fast nie das von TikTok, sondern die Bandbreite.
Häufige Fragen
- Gelten die TikTok-API-Rate-Limits pro App oder pro Nutzer?
- Die Content-Posting-Endpoints sind pro User-Access-Token dokumentiert – also pro verbundenem Konto. TikTok veröffentlicht für diese Endpoints keine eigene appweite Obergrenze und erklärt, dass die Limits für jede API separat festgelegt und durchgesetzt werden.
- Welchen Fehler gibt TikTok zurück, wenn ein Rate Limit überschritten wird?
- HTTP-Status 429, mit dem Fehlercode rate_limit_exceeded im Response-Body.
- Lassen sich die TikTok-API-Rate-Limits erhöhen?
- Ja. Laut TikToks Dokumentation kannst du höhere Limits über die Support-Seite beantragen, und jede Anfrage wird geprüft.
- Wie hoch ist das Rate Limit der TikTok Events API pro Sekunde?
- 1.000 Anfragen pro Sekunde, 600.000 pro Minute und 86.400.000 pro Tag, für /event/track/, Web Events, App Events und Offline Events gleichermaßen. TikTok wendet auf allen vier Anwendungsstufen denselben Wert an und erklärt, dass du für die Events API keine Erhöhung beantragen musst.
- Ist das Rate Limit der Events API dasselbe wie das der Content Posting API?
- Nein, es ist nicht einmal dasselbe System. Content Posting ist auf developers.tiktok.com dokumentiert, wird pro Minute gegen ein User-Access-Token gezählt und antwortet mit HTTP 429 und rate_limit_exceeded. Die Events API gehört zur Marketing API auf business-api.tiktok.com, wird in Anfragen pro Sekunde, Minute und Tag gegen deine Entwickleranwendung gezählt und antwortet mit dem Code 40100.
- Wie viele TikTok-Videos kann ich pro Minute über die API posten?
- Sechs pro verbundenem Konto, denn der Direct-Post-Endpoint erlaubt 6 Anfragen pro Minute und User-Access-Token. Bei zehn verbundenen Konten sind das sechzig, weil jedes Konto sein eigenes Limit hat.
Quellen
- TikTok for Developers — Rate Limits on API Requests — gelesen am .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — gelesen am .
- TikTok for Developers — Content Posting API, Direct Post — gelesen am .
- TikTok for Developers — Query Creator Info — gelesen am .
Diese Zahlen stammen aus der Dokumentation eines anderen Unternehmens. Sie kann sich ohne Ankündigung ändern, und nichts hier prüft sie automatisch nach. Deshalb trägt jede Quelle das Datum, an dem sie gelesen wurde. Die Quellen dieser Seite werden jedes Quartal neu gelesen.
So ist diese Seite entstanden: mit KI-Unterstützung verfasst, auf Grundlage der auf dieser Seite genannten Quellen, gelesen am .