Rate limit ng TikTok Events API: 1,000 request/s (2026)
Huling sinuri noong · mga source na nakalista sa ibaba ng page na ito
Hiwa-hiwalay ang rate limit ng TikTok sa bawat endpoint, sa isang one-minute sliding window. Pinapayagan ng Direct Post endpoint ang 6 na request kada minuto bawat user access token, 20 ang Query Creator Info, 30 ang Get Post Status, at 600 bawat isa ang mga read endpoint ng user at video (/v2/user/info/, /v2/video/query/, /v2/video/list/). Kapag lumampas ka, HTTP 429 ang sagot na may error code na rate_limit_exceeded. Ibang sistema sa ibang host ang Events API: 1,000 request bawat segundo, pareho sa lahat ng application level, at code 40100 ang sagot kapag na-throttle.
Ano ang rate limit ng bawat endpoint ng TikTok API?
Itinatakda at ipinapatupad ang mga limit kada endpoint, hindi bilang iisang shared na budget. Kapag naubos mo ang Direct Post, hindi bumabagal ang Get Post Status, at ganoon din pabalik.
| Endpoint | Limit | Ano ang ibig sabihin nito sa praktika |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 request / minuto kada user access token | Ito ang limit na tatamaan ng sinumang nagpo-post sa ilang account. Kada token ito, kaya kada naka-connect na account — hindi naghahati ang sampung account sa anim na request, tig-aanim sila. |
| Query Creator Info | 20 request / minuto kada user access token | Tinatawag bago ang bawat post, dahil kailangang ipakita ng posting UI ang totoong privacy options ng creator. Kaya ang isang publish flow ay hindi bababa sa dalawang call, hindi isa. |
| Get Post Status | 30 request / minuto kada user access token | Polling. Mukhang marami ang tatlumpu kada minuto hanggang mag-poll ka ng sampung account bawat dalawang segundo — 300 iyon. |
| /v2/user/info/ | 600 request / minuto | Pagbasa ng profile. |
| /v2/video/query/ | 600 request / minuto | Metrics ng mga partikular na video. |
| /v2/video/list/ | 600 request / minuto | Listahan ng mga video ng creator, naka-paginate. |
Paano kinakalkula ang window, at ano ang nangyayari kapag lumampas ka?
Gumagamit ang kalkulasyon ng one-minute sliding window, hindi ng nakapirming minuto sa orasan. Ang sunod-sunod na anim na post sa 10:00:59 ay hindi nare-reset sa 10:01:00 — patuloy itong binibilang hanggang 10:01:59.
Kapag lumampas sa threshold, HTTP 429 ang sagot ng API na may error code na rate_limit_exceeded. Sinasabi ng TikTok na puwedeng itaas ang limit kapag hiniling sa kanilang support page, at sinusuri ito isa-isa.
Ang praktikal na epekto para sa nagpo-post sa maraming account: ang retry sa 429 ay dapat mag-back off, hindi umulit agad. Pinahahaba ng agarang retry ang mismong window na sinusubukan nitong takasan.
Ano ang rate limit ng TikTok Events API, sa request bawat segundo?
Isang libo bawat segundo, at pareho ang numerong ito para sa bawat developer application — ito lang ang lugar kung saan hindi ka pinapa-apply ng TikTok para sa mas mataas.
Ibang API ito sa lahat ng endpoint sa itaas, at dito madalas nalilito ang mga tao. Nasa developers.tiktok.com ang mga Content Posting endpoint at binibilang kada minuto, kada user access token. Bahagi naman ng Marketing API sa business-api.tiktok.com ang Events API, at binibilang ito sa QPS, QPM at QPD laban sa developer application mo. Dalawang host, dalawang sistema, dalawang error code: "code": 40100 ang sagot ng Marketing API, samantalang HTTP 429 ang sagot ng developer API.
Nasa isa rin sa apat na global level ang application mo — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, at nagsisimula sa Basic ang bawat app. Hayagang hindi kasama sa hagdang iyon ang mga Events endpoint: sinasabi ng TikTok na hindi mo kailangang mag-apply ng rate limit level change para sa Events API, dahil pareho ang rate limit sa lahat ng level. Kaya ang 1,000 QPS sa ibaba ang makukuha ng bagong-bagong app sa unang araw.
| Endpoint | Limit | Ano ang ibig sabihin nito sa praktika |
|---|---|---|
| Web Events (/pixel/track/) at /pixel/batch/ | 1,000 / segundo · 600,000 / minuto · 86,400,000 / araw | Mga web conversion mula sa browser at server-side. Eksaktong 1,000 × 86,400 ang daily figure, kaya ang per-second limit lang ang realistikong matatamaan mo. |
| App Events (/app/track/) at /app/batch/ | 1,000 / segundo · 600,000 / minuto · 86,400,000 / araw | Mga conversion sa mobile app. |
| Offline Events (/offline/track/) at /offline/batch/ | 1,000 / segundo · 600,000 / minuto · 86,400,000 / araw | Mga conversion sa physical store at CRM na ipinapadala pagkatapos. |
| /event/track/ | 1,000 / segundo · 600,000 / minuto · 86,400,000 / araw | Ang endpoint ng Events API 2.0. |
| Streaming API | 10,000 / segundo sa Basic, hanggang 50,000 sa Ultimate | Ang nag-iisang limit sa events side na sumusunod sa hagdan ng level. |
Bakit hindi sampung beses na mas matagal ang pag-post sa sampung account?
Dahil bawat limit sa itaas ay naka-scope sa isang user access token, at ang isang token ay isang naka-connect na account. Ang sampung account ay sampung magkakahiwalay na bucket na may tig-anim na post kada minuto.
Ang talagang nagpapasunod-sunod ay ang sarili mong infrastructure: ang isang video file na in-upload nang sampung beses ay sampung transfer. Halos hindi kailanman TikTok ang unang limit na tatamaan mo — bandwidth iyon.
Mga madalas itanong
- Kada app ba o kada user ang rate limit ng TikTok API?
- Nakadokumento ang mga Content Posting endpoint kada user access token — kaya kada naka-connect na account. Walang hiwalay na app-wide na ceiling na inilalathala ang TikTok para sa mga endpoint na ito, at sinasabi nitong itinatakda at ipinapatupad nang hiwalay ang limit sa bawat API.
- Anong error ang ibinabalik ng TikTok kapag lumampas sa rate limit?
- HTTP status 429, na may error code na rate_limit_exceeded sa response body.
- Puwede bang itaas ang rate limit ng TikTok API?
- Oo. Sinasabi ng documentation ng TikTok na puwedeng humiling ng mas mataas na limit sa kanilang support page, at sinusuri ang bawat request.
- Ano ang rate limit ng TikTok Events API bawat segundo?
- 1,000 request bawat segundo, 600,000 kada minuto at 86,400,000 kada araw, para sa /event/track/, Web Events, App Events at Offline Events. Pareho ang numerong ito sa lahat ng apat na application level, at sinasabi ng TikTok na hindi mo kailangang mag-apply ng increase para sa Events API.
- Pareho ba ang rate limit ng Events API at ng Content Posting API?
- Hindi, at hindi rin sila iisang sistema. Nakadokumento ang Content Posting sa developers.tiktok.com, binibilang kada minuto laban sa user access token, at HTTP 429 na may rate_limit_exceeded ang sagot. Kabilang ang Events API sa Marketing API sa business-api.tiktok.com, binibilang sa request bawat segundo, minuto at araw laban sa developer application mo, at code 40100 ang sagot.
- Ilang TikTok video ang puwede kong i-post kada minuto sa API?
- Anim kada naka-connect na account, dahil pinapayagan ng Direct Post endpoint ang 6 na request kada minuto bawat user access token. Sa sampung naka-connect na account, animnapu iyon, dahil may sariling limit ang bawat account.
Mga source
- TikTok for Developers — Rate Limits on API Requests — binasa noong .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — binasa noong .
- TikTok for Developers — Content Posting API, Direct Post — binasa noong .
- TikTok for Developers — Query Creator Info — binasa noong .
Galing ang mga numerong ito sa dokumentasyon ng ibang kumpanya, na puwedeng magbago nang walang abiso at hindi awtomatikong vine-verify ng kahit ano rito. Kaya bawat source ay may petsa kung kailan ito binasa. Binabasa ulit ang mga source sa page na ito bawat quarter.
Paano ginawa ang page na ito: isinulat sa tulong ng AI mula sa mga source na nakalista sa page na ito, binasa noong .