TikTok Events API: gräns på 1 000 anrop/s (2026)
Senast kontrollerad · källorna listas längst ner på sidan
TikTok begränsar varje endpoint för sig, mot ett glidande fönster på en minut. Direct Post tillåter 6 anrop per minut per user access token, Query Creator Info 20, Get Post Status 30, och läs-endpoints för användare och videor (/v2/user/info/, /v2/video/query/, /v2/video/list/) 600 vardera. Går du över får du HTTP 429 med felkoden rate_limit_exceeded. Events API är ett separat system på en separat host: 1 000 anrop per sekund, lika på alla appnivåer, och svarar med kod 40100 när det stryps.
Vilken gräns gäller för varje endpoint i TikToks API?
Gränserna sätts och upprätthålls per endpoint, inte som en gemensam budget. Att tömma Direct Post bromsar inte Get Post Status, och tvärtom.
| Endpoint | Gräns | Vad det betyder i praktiken |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 anrop / minut per user access token | Den gräns som binder för alla som publicerar till flera konton. Den gäller per token, alltså per anslutet konto — tio konton delar inte på sex anrop, de har sex var. |
| Query Creator Info | 20 anrop / minut per user access token | Anropas före varje inlägg, eftersom publiceringsgränssnittet måste visa kreatörens verkliga sekretessval. Därför kostar ett publiceringsflöde minst två anrop, inte ett. |
| Get Post Status | 30 anrop / minut per user access token | Pollning. Trettio i minuten låter generöst tills du pollar tio konton varannan sekund — det blir 300. |
| /v2/user/info/ | 600 anrop / minut | Läsning av profiler. |
| /v2/video/query/ | 600 anrop / minut | Mätvärden för specifika videor. |
| /v2/video/list/ | 600 anrop / minut | Sidindelad lista över en kreatörs videor. |
Hur räknas fönstret, och vad händer när du går över?
Beräkningen använder ett glidande fönster på en minut, inte en fast klockminut. En skur på sex inlägg klockan 10:00:59 nollställs inte 10:01:00 — den fortsätter räknas till 10:01:59.
Över tröskeln svarar API:et HTTP 429 med felkoden rate_limit_exceeded. TikTok uppger att gränserna kan höjas på begäran via deras supportsida, efter prövning från fall till fall.
Den praktiska följden för den som publicerar till många konton: ett nytt försök efter en 429 måste vänta, inte upprepas direkt. Ett omedelbart nytt försök förlänger just det fönster det försöker ta sig ur.
Vilken gräns har TikToks Events API, i anrop per sekund?
Tusen per sekund, och siffran är densamma för alla utvecklarappar — det här är det enda stället där TikTok inte låter dig ansöka om mer.
Det är ett annat API än alla endpoints ovan, och det är där många går bet. Content Posting-endpoints ligger på developers.tiktok.com och räknas per minut, per user access token. Events API är en del av Marketing API på business-api.tiktok.com och räknas i QPS, QPM och QPD mot din utvecklarapp. Två hosts, två system, två felkoder: Marketing API svarar "code": 40100 där utvecklar-API:et svarar HTTP 429.
Din app ligger dessutom på en av fyra globala nivåer — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, och alla appar börjar på Basic. Events-endpoints är uttryckligen undantagna från den stegen: TikTok anger att du inte behöver ansöka om ändrad nivå för Events API, eftersom gränsen är densamma för alla nivåer. De 1 000 QPS nedan är alltså vad en helt ny app får från dag ett.
| Endpoint | Gräns | Vad det betyder i praktiken |
|---|---|---|
| Web Events (/pixel/track/) och /pixel/batch/ | 1 000 / sekund · 600 000 / minut · 86 400 000 / dag | Webbkonverteringar från webbläsaren och serversidan. Dagssiffran är exakt 1 000 × 86 400, så sekundgränsen är den enda du realistiskt kan slå i. |
| App Events (/app/track/) och /app/batch/ | 1 000 / sekund · 600 000 / minut · 86 400 000 / dag | Konverteringar i mobilappar. |
| Offline Events (/offline/track/) och /offline/batch/ | 1 000 / sekund · 600 000 / minut · 86 400 000 / dag | Konverteringar i butik och från CRM som skickas i efterhand. |
| /event/track/ | 1 000 / sekund · 600 000 / minut · 86 400 000 / dag | Endpointen för Events API 2.0. |
| Streaming API | 10 000 / sekund på Basic, upp till 50 000 på Ultimate | Den enda gränsen på eventsidan som faktiskt följer nivåstegen. |
Varför tar det inte tio gånger längre att publicera till tio konton?
För att varje gräns ovan gäller per user access token, och en token är ett anslutet konto. Tio konton är tio oberoende hinkar med sex inlägg per minut.
Det som däremot köas är din egen infrastruktur: en videofil som laddas upp tio gånger är tio överföringar. Gränsen som slår till först är nästan aldrig TikToks, utan bandbredden.
Vanliga frågor
- Gäller TikToks API-gränser per app eller per användare?
- Content Posting-endpoints är dokumenterade per user access token — alltså per anslutet konto. TikTok publicerar inget separat tak för hela appen för de här endpoints, och anger att gränserna sätts och upprätthålls separat för varje API.
- Vilket fel returnerar TikTok när en gräns överskrids?
- HTTP-status 429, med felkoden rate_limit_exceeded i svarets body.
- Kan TikToks API-gränser höjas?
- Ja. TikToks dokumentation anger att högre gränser kan begäras via deras supportsida, och att varje begäran prövas.
- Vilken gräns per sekund har TikToks Events API?
- 1 000 anrop per sekund, 600 000 per minut och 86 400 000 per dag, för /event/track/, Web Events, App Events och Offline Events lika. TikTok tillämpar samma siffra på alla fyra appnivåer och anger att du inte behöver ansöka om en höjning för Events API.
- Är gränsen för Events API densamma som för Content Posting API?
- Nej, och det är inte ens samma system. Content Posting är dokumenterat på developers.tiktok.com, räknas per minut mot en user access token och svarar HTTP 429 med rate_limit_exceeded. Events API hör till Marketing API på business-api.tiktok.com, räknas i anrop per sekund, minut och dag mot din utvecklarapp och svarar med kod 40100.
- Hur många TikTok-videor kan jag publicera per minut via API:et?
- Sex per anslutet konto, eftersom Direct Post tillåter 6 anrop per minut per user access token. Över tio anslutna konton blir det sextio, eftersom varje konto har sin egen gräns.
Källor
- TikTok for Developers — Rate Limits on API Requests — lästa .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — lästa .
- TikTok for Developers — Content Posting API, Direct Post — lästa .
- TikTok for Developers — Query Creator Info — lästa .
Siffrorna kommer från ett annat företags dokumentation, som kan ändras utan förvarning och som inget här kontrollerar automatiskt. Därför bär varje källa datumet då den lästes. Källorna på den här sidan läses om varje kvartal.
Så gjordes den här sidan: skriven med hjälp av AI utifrån källorna på den här sidan, lästa .