Limit Events API TikToka: 1000 zapytań/s (2026)
Sprawdzono · źródła wymienione na dole tej strony
TikTok ogranicza liczbę zapytań osobno dla każdego endpointu, w przesuwnym oknie jednej minuty. Endpoint Direct Post pozwala na 6 zapytań na minutę na user access token, Query Creator Info na 20, Get Post Status na 30, a endpointy odczytu użytkowników i filmów (/v2/user/info/, /v2/video/query/, /v2/video/list/) na 600 każdy. Przekroczenie zwraca HTTP 429 z kodem błędu rate_limit_exceeded. Events API to osobny system na osobnym hoście: 1000 zapytań na sekundę, tyle samo na każdym poziomie aplikacji, a przy ograniczeniu odpowiada kodem 40100.
Jaki jest limit zapytań dla każdego endpointu API TikToka?
Limity są ustalane i egzekwowane dla każdego endpointu z osobna, a nie jako jeden wspólny budżet. Wyczerpanie Direct Post nie spowalnia Get Post Status i odwrotnie.
| Endpoint | Limit | Co to oznacza w praktyce |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 zapytań / minutę na user access token | Wiążący limit dla każdego, kto publikuje na kilku kontach. Liczy się na token, czyli na połączone konto: dziesięć kont nie dzieli się sześcioma zapytaniami, każde ma swoje sześć. |
| Query Creator Info | 20 zapytań / minutę na user access token | Wywoływany przed każdym postem, bo interfejs publikacji musi pokazać prawdziwe opcje prywatności twórcy. Dlatego publikacja kosztuje co najmniej dwa wywołania, a nie jedno. |
| Get Post Status | 30 zapytań / minutę na user access token | Odpytywanie. Trzydzieści na minutę brzmi hojnie, dopóki nie odpytujesz dziesięciu kont co dwie sekundy: to 300. |
| /v2/user/info/ | 600 zapytań / minutę | Odczyty profilu. |
| /v2/video/query/ | 600 zapytań / minutę | Metryki konkretnych filmów. |
| /v2/video/list/ | 600 zapytań / minutę | Stronicowana lista filmów twórcy. |
Jak liczone jest okno i co się dzieje po jego przekroczeniu?
Obliczenia używają przesuwnego okna jednej minuty, a nie stałej minuty zegarowej. Seria sześciu postów o 10:00:59 nie zeruje się o 10:01:00: liczy się dalej do 10:01:59.
Powyżej progu API odpowiada HTTP 429 z kodem błędu rate_limit_exceeded. TikTok podaje, że limity można podnieść na wniosek złożony przez stronę wsparcia, rozpatrywany indywidualnie.
Praktyczna konsekwencja dla kogoś, kto publikuje na wielu kontach: ponowna próba po 429 musi odczekać, a nie powtarzać od razu. Natychmiastowa ponowna próba wydłuża okno, z którego próbuje się wydostać.
Jaki jest limit zapytań Events API TikToka na sekundę?
Tysiąc na sekundę, i to ta sama liczba dla każdej aplikacji deweloperskiej: to jedyne miejsce, w którym TikTok nie każe ci prosić o więcej.
To inne API niż wszystkie endpointy powyżej i właśnie to ludzi myli. Endpointy Content Posting działają na developers.tiktok.com i są liczone na minutę, na user access token. Events API jest częścią Marketing API na business-api.tiktok.com i jest liczone w QPS, QPM i QPD dla twojej aplikacji deweloperskiej. Dwa hosty, dwa systemy, dwa kody błędów: Marketing API odpowiada "code": 40100 tam, gdzie API dla deweloperów odpowiada HTTP 429.
Twoja aplikacja ma też jeden z czterech globalnych poziomów (Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50), a każda aplikacja zaczyna od Basic. Endpointy Events są z tej drabinki wprost wyłączone: TikTok podaje, że nie musisz wnioskować o zmianę poziomu limitu dla Events API, bo limit jest taki sam na wszystkich poziomach. Zatem 1000 QPS poniżej to coś, co zupełnie nowa aplikacja dostaje od pierwszego dnia.
| Endpoint | Limit | Co to oznacza w praktyce |
|---|---|---|
| Web Events (/pixel/track/) i /pixel/batch/ | 1000 / sekundę · 600 000 / minutę · 86 400 000 / dzień | Konwersje webowe z przeglądarki i z serwera. Wartość dzienna to dokładnie 1000 × 86 400, więc limit na sekundę to jedyny, który realnie możesz osiągnąć. |
| App Events (/app/track/) i /app/batch/ | 1000 / sekundę · 600 000 / minutę · 86 400 000 / dzień | Konwersje z aplikacji mobilnych. |
| Offline Events (/offline/track/) i /offline/batch/ | 1000 / sekundę · 600 000 / minutę · 86 400 000 / dzień | Konwersje sklepowe i z CRM wysyłane po fakcie. |
| /event/track/ | 1000 / sekundę · 600 000 / minutę · 86 400 000 / dzień | Endpoint Events API 2.0. |
| Streaming API | 10 000 / sekundę na Basic, do 50 000 na Ultimate | Jedyny limit po stronie zdarzeń, który faktycznie podąża za drabinką poziomów. |
Dlaczego publikacja na dziesięciu kontach nie trwa dziesięć razy dłużej?
Bo każdy limit powyżej jest przypisany do user access tokena, a jeden token to jedno połączone konto. Dziesięć kont to dziesięć niezależnych puli po sześć postów na minutę.
Kolejkuje się natomiast twoja własna infrastruktura: jeden plik wideo wgrany dziesięć razy to dziesięć transferów. Limit, który uderza pierwszy, prawie nigdy nie jest limitem TikToka, tylko przepustowością.
Najczęstsze pytania
- Czy limity zapytań API TikToka liczą się na aplikację, czy na użytkownika?
- Endpointy Content Posting są udokumentowane na user access token, czyli na połączone konto. TikTok nie publikuje osobnego limitu dla całej aplikacji dla tych endpointów i podaje, że limity są ustalane i egzekwowane osobno dla każdego API.
- Jaki błąd zwraca TikTok po przekroczeniu limitu zapytań?
- Status HTTP 429 z kodem błędu rate_limit_exceeded w treści odpowiedzi.
- Czy można zwiększyć limity zapytań API TikToka?
- Tak. Dokumentacja TikToka podaje, że o wyższe limity można wnioskować przez stronę wsparcia i że każdy wniosek jest rozpatrywany.
- Jaki jest limit zapytań Events API TikToka na sekundę?
- 1000 zapytań na sekundę, 600 000 na minutę i 86 400 000 na dzień, tak samo dla /event/track/, Web Events, App Events i Offline Events. TikTok stosuje tę samą wartość na wszystkich czterech poziomach aplikacji i podaje, że dla Events API nie trzeba wnioskować o zwiększenie.
- Czy limit Events API jest taki sam jak limit Content Posting API?
- Nie, i to nawet nie jest ten sam system. Content Posting jest udokumentowane na developers.tiktok.com, liczone na minutę dla user access tokena i odpowiada HTTP 429 z rate_limit_exceeded. Events API należy do Marketing API na business-api.tiktok.com, jest liczone w zapytaniach na sekundę, minutę i dzień dla twojej aplikacji deweloperskiej i odpowiada kodem 40100.
- Ile filmów na TikToka mogę opublikować na minutę przez API?
- Sześć na połączone konto, bo endpoint Direct Post pozwala na 6 zapytań na minutę na user access token. Przy dziesięciu połączonych kontach to sześćdziesiąt, bo każde konto ma własny limit.
Źródła
- TikTok for Developers — Rate Limits on API Requests — odczytano .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — odczytano .
- TikTok for Developers — Content Posting API, Direct Post — odczytano .
- TikTok for Developers — Query Creator Info — odczytano .
Te dane pochodzą z dokumentacji innej firmy, która może się zmienić bez uprzedzenia i której nic tutaj nie weryfikuje automatycznie. Dlatego przy każdym źródle podajemy datę odczytu. Źródła na tej stronie są czytane ponownie co kwartał.
Jak powstała ta strona: napisana z pomocą AI na podstawie źródeł wymienionych na tej stronie, odczytanych .