TikTok API Rate Limits: Anfragen pro Konto, App und Endpoint
Die API for Business von TikTok begrenzt Aufrufe gleichzeitig auf drei Ebenen: 40 pro Minute und autorisiertem Konto auf jedem Endpoint der Accounts API, ein gemeinsames Accounts-API-Budget pro Entwickler-App von 600 pro Minute bei Basic und 1,000 darüber sowie App-Limits pro Endpoint von 10 pro Sekunde, 600 pro Minute und 864,000 pro Tag bei Basic, die bei Ultimate auf 50 pro Sekunde steigen.
easyCoexistence veröffentlicht Beiträge, liest Insights und beantwortet Kommentare auf TikTok für Claude, ChatGPT oder Ihren eigenen Code über die API for Business von TikTok.
Abfragen pro Minute und autorisiertem TikTok-Konto auf jedem Endpoint der Accounts API, ein einheitlicher Wert, unabhängig von der Stufe der App.
Budget für alle Accounts-API-Endpoints zusammen pro Entwickler-App bei Advanced, Premium und Ultimate; Basic erhält 600.
Limit pro Endpoint bei Ultimate, der höchsten App-Stufe, neben 3,000 Abfragen pro Minute und 4,320,000 pro Tag.
Status, den TikTok zusammen mit seinen Rückgabecodes liefert, einschließlich 4xxxx-Codes wie 40100; nur Code 0 bedeutet Erfolg.
Rate Limit für jeden Discovery-API-Endpoint pro Entwickler-App.
Wann tägliche Limits zurückgesetzt werden; nach einem Minuten-Limit verlangt TikTok stattdessen eine 5-minütige Pause.
Welche Limits gelten für einen TikTok-API-Aufruf?
Bei jedem Accounts-API-Aufruf laufen bis zu drei Zähler mit, und manche Produkte und Aktionen führen eigene Zähler. TikTok hält die Endpoint-Zähler unabhängig voneinander, sodass ein Endpoint gedrosselt werden kann, während die anderen Endpoints der App weiter antworten:
Was erlauben die vier App-Stufen?
Alle Entwickler-Apps beginnen bei Basic. TikTok stuft eine App auf Anfrage unter Meine Apps, App-Details, Autorisierung mit Begründung jeweils eine Stufe höher. Jede Stufe legt fest, was ein einzelner Endpoint von der App beanspruchen kann, neben dem gemeinsamen Budget für Accounts-API-Aufrufe:
Erhöht eine höhere Stufe das Accounts-API-Budget?
Einmal. Der Wechsel von Basic zu Advanced hebt das gemeinsame Accounts-API-Budget von 600 auf 1,000 Abfragen pro Minute, und es bleibt bei 1,000 über Premium und Ultimate, während die Endpoint-Limits pro Sekunde und pro Tag weiter steigen. Das Limit von 40 pro Minute und Konto und Endpoint ändert sich mit der Stufe gar nicht. Ein einzelnes stark genutztes Konto wird auf einem Endpoint daher bei 40 Aufrufen pro Minute gedrosselt, unabhängig davon, welche Stufe die App hat.
Wie summieren sich die Limits über viele Konten?
Das Konto-Limit vervielfacht sich mit jedem Konto, das Budget der App nicht. Zehn Konten können jeweils 40 Aufrufe pro Minute an /business/comment/list/ senden, zusammen 400. Bei zwanzig Konten, die dasselbe tun, wären es jedoch 800, mehr als die 600, die eine Basic-App für ihre Accounts-API-Aufrufe insgesamt hat, bevor andere Endpoints gezählt werden. Oberhalb von Basic liegt dieses gemeinsame Budget bei höchstens 1,000 pro Minute.
Was passiert, wenn ein Aufruf ein Limit überschreitet?
TikTok drosselt diesen Endpoint. Dessen Leitfaden zu Rate Limits nennt den Code 40100 für einen gedrosselten Aufruf. Er kommt im Antworttext einer HTTP-200-Antwort. Der Endpoint bleibt nach einem Minuten-Limit 5 Minuten gesperrt, nach einem Tageslimit bis zum Zurücksetzen der täglichen Zähler um 00:00 UTC, während die anderen Endpoints der App weiter antworten. Das Erkennen im Code und das sinnvolle Wiederholen sind Thema von Fehlercode 40100.
Sind die Beschränkungen für Veröffentlichungen Rate Limits?
Nein. Sie zählen Beiträge statt Aufrufe und haben eine eigene Seite. TikTok erlaubt einem Konto sechs Beiträge pro Minute und 15 pro Tag über /business/video/publish/, ebenso über /business/photo/publish/. Ein Beitrag darüber schlägt mit spam_risk_too_many_posts im Veröffentlichungsstatus fehl, während ein Anfrage-Limit den Aufruf selbst ablehnt.
Welche Gewohnheiten verbrauchen die Limits am schnellsten?
Polling. Wer den Veröffentlichungsstatus oder eine Kommentarliste per Timer abfragt, verbraucht die 40 Aufrufe pro Minute an diesem Endpoint, ob sich etwas geändert hat oder nicht. Genau dafür gibt es die Webhooks von TikTok: Publishing-Ereignisse melden jede Phase eines Beitrags, und comment.update meldet einen neuen Kommentar innerhalb von 5 Minuten. Seitenweises Lesen mit 20 Beiträgen oder 30 Kommentaren pro Aufruf und das einmal tägliche Abrufen von Erwähnungen halten den Rest niedrig.
Wie geht easyCoexistence mit einem gedrosselten TikTok-Aufruf um?
Es gibt die Antwort von TikTok weiter, statt sie zu verbergen. Ein Tool-Aufruf, den TikTok drosselt, etwa list_social_comments, reply_to_comment oder get_tiktok_publish_status, kommt bei der KI als Fehler zurück, der den Code 40100 und die Nachricht von TikTok nennt, und wird nicht selbstständig wiederholt. Beiträge laufen über einen anderen Weg: publish_tiktok_post übergibt jeden Beitrag an die Warteschlange von easyCoexistence, sofort oder zu einem festen Zeitpunkt:
- Die Warteschlange wartet 5 Minuten, 30 Minuten und 2 Stunden und versucht es dann erneut, wenn eine Antwort als HTTP 429 zurückkommt.
- TikTok sendet 40100 in einer HTTP-200-Antwort. Daher schlägt eine gedrosselte TikTok-Veröffentlichung mit der Nachricht von TikTok fehl und wartet unter „Benötigt Aufmerksamkeit“ auf eine Wiederholung.
- Ein 40100 bei einer der Statusprüfungen der Warteschlange lässt den Beitrag ebenfalls fehlschlagen, obwohl TikTok ihn möglicherweise bereits veröffentlicht hat. Prüfen Sie vor dem Wiederholen die neuesten Beiträge des Kontos.
- Ein Beitrag, der im Hintergrund fehlschlägt, benachrichtigt den Inhaber per E-Mail, höchstens einmal pro Kanal alle 3 Stunden.
Welche TikTok-Aufrufe macht easyCoexistence für ein Konto?
Wenige, und sie zählen gegen die Limits des Kontos, genauso wie Ihre eigenen Aufrufe:
- /business/get/ etwa alle 6 Stunden, um zu prüfen, ob das Konto noch antwortet.
- Ein Veröffentlichungsaufruf pro Beitrag, danach /business/publish/status/ etwa alle 20 Sekunden, bis TikTok den Beitrag abschließt oder fehlschlagen lässt, höchstens 2 Stunden lang.
- Bei aktiven Kommentarregeln oder Automatisierungen je ein /business/comment/list/-Aufruf pro neuem Kommentar der obersten Ebene, um dessen Autor zu lesen, und ein Aufruf für jede veröffentlichte Antwort.
- Tool-Aufrufe nur, wenn die KI oder Ihr Code sie anfordert, mit 20 Beiträgen oder 30 Kommentaren pro Lesevorgang.
Häufige Fehler
- Drosselung am HTTP-Status erkennen. TikTok antwortet mit 40100 bei HTTP 200, daher übersieht eine Prüfung auf res.ok oder auf 429 sie. Lesen Sie den Code im Antworttext.
- Die Stufe der App anheben, um ein stark genutztes Konto zu entlasten. Die 40 Aufrufe pro Minute und Konto und Endpoint bleiben auf allen vier Stufen gleich. Verteilen Sie die Aufrufe dieses Kontos deshalb über die Zeit.
- Mentions-Daten mehrmals täglich abrufen. TikTok aktualisiert sie einmal, zwischen Mitternacht und 7 Uhr UTC, und empfiehlt einen Aufruf pro Endpoint und Konto am Tag.
Wird ein Aufruf gedrosselt, gibt es den Code und die Nachricht von TikTok zurück, und jeder Beitrag wird verfolgt, bis TikTok ihn abschließt oder fehlschlagen lässt. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Wie hoch ist das TikTok-API-Rate-Limit pro Konto?
40 Abfragen pro Minute auf jedem Accounts-API-Endpoint für jedes autorisierte TikTok-Konto, innerhalb des gemeinsamen Budgets der Entwickler-App von 600 pro Minute bei Basic oder 1,000 darüber.
Werden TikTok-Rate-Limits pro Endpoint gezählt?
Ja. Der Leitfaden von TikTok sagt, dass endpoint-spezifische Limits unabhängig sind. Das Erreichen des Limits eines Endpoints stoppt daher keine Aufrufe an einen anderen Endpoint.
Wie erhöhe ich mein TikTok-API-Rate-Limit?
Beantragen Sie es unter Meine Apps, App-Details, Autorisierung und geben Sie eine Begründung an. Die Stufen steigen jeweils um eine Stufe, von Basic zu Advanced, dann Premium und schließlich Ultimate.
Zählen Aufrufe über easyCoexistence auf die Limits von TikTok?
Ja. Sie laufen als verbundenes Konto mit dessen Token und zählen daher wie jeder andere Aufruf für dieses Konto auf dessen 40 Aufrufe pro Minute und Endpoint.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am