Batas Rate Events API TikTok: 1.000 Request/dtk (2026)
Terakhir dicek · sumber tercantum di bagian bawah halaman ini
TikTok membatasi rate setiap endpoint secara terpisah, dengan jendela geser satu menit. Endpoint Direct Post mengizinkan 6 request per menit per user access token, Query Creator Info mengizinkan 20, Get Post Status mengizinkan 30, dan endpoint baca pengguna serta video (/v2/user/info/, /v2/video/query/, /v2/video/list/) masing-masing mengizinkan 600. Jika terlampaui, API mengembalikan HTTP 429 dengan kode error rate_limit_exceeded. Events API adalah sistem terpisah di host terpisah: 1.000 request per detik, sama di semua level aplikasi, dan menjawab dengan kode 40100 saat dibatasi.
Berapa batas rate untuk setiap endpoint API TikTok?
Batasnya ditetapkan dan diterapkan per endpoint, bukan sebagai satu anggaran bersama. Menghabiskan jatah Direct Post tidak memperlambat Get Post Status, begitu juga sebaliknya.
| Endpoint | Batas | Artinya dalam praktik |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 request / menit per user access token | Batas yang paling mengikat bagi siapa pun yang memposting ke beberapa akun. Batasnya per token, jadi per akun yang terhubung — sepuluh akun tidak berbagi enam request, masing-masing punya enam. |
| Query Creator Info | 20 request / menit per user access token | Dipanggil sebelum setiap posting, karena UI posting wajib menampilkan opsi privasi asli milik kreator. Itulah sebabnya satu alur publikasi butuh minimal dua panggilan, bukan satu. |
| Get Post Status | 30 request / menit per user access token | Polling. Tiga puluh per menit terdengar longgar sampai Anda melakukan polling ke sepuluh akun setiap dua detik — itu 300. |
| /v2/user/info/ | 600 request / menit | Pembacaan profil. |
| /v2/video/query/ | 600 request / menit | Metrik untuk video tertentu. |
| /v2/video/list/ | 600 request / menit | Daftar video kreator, per halaman. |
Bagaimana jendelanya dihitung, dan apa yang terjadi jika terlampaui?
Perhitungannya memakai jendela geser satu menit, bukan menit jam yang tetap. Lonjakan enam posting pada 10:00:59 tidak direset pada 10:01:00 — hitungannya berlanjut sampai 10:01:59.
Di atas ambang, API menjawab HTTP 429 dengan kode error rate_limit_exceeded. TikTok menyatakan bahwa batas bisa dinaikkan atas permintaan lewat halaman dukungannya, ditinjau kasus per kasus.
Konsekuensi praktis bagi penerbit multi-akun: retry setelah 429 harus mundur dulu, bukan langsung mengulang. Retry seketika justru memperpanjang jendela yang sedang ingin dihindari.
Berapa batas rate Events API TikTok, dalam request per detik?
Seribu per detik, dan angkanya sama untuk setiap aplikasi developer — inilah satu-satunya tempat TikTok tidak mengharuskan Anda mengajukan permohonan untuk batas lebih tinggi.
Ini API yang berbeda dari semua endpoint di atas, dan bagian inilah yang sering menjebak. Endpoint Content Posting berada di developers.tiktok.com dan dihitung per menit, per user access token. Events API adalah bagian dari Marketing API di business-api.tiktok.com, dan dihitung dalam QPS, QPM, dan QPD terhadap aplikasi developer Anda. Dua host, dua sistem, dua kode error: Marketing API menjawab "code": 40100, sedangkan API developer menjawab HTTP 429.
Aplikasi Anda juga berada di salah satu dari empat level global — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, dan setiap aplikasi mulai dari Basic. Endpoint Events secara eksplisit dikecualikan dari tangga itu: TikTok menyatakan Anda tidak perlu mengajukan perubahan level batas rate untuk Events API, karena batasnya sama untuk semua level. Jadi 1.000 QPS di bawah ini adalah yang didapat aplikasi yang benar-benar baru sejak hari pertama.
| Endpoint | Batas | Artinya dalam praktik |
|---|---|---|
| Web Events (/pixel/track/) dan /pixel/batch/ | 1.000 / detik · 600.000 / menit · 86.400.000 / hari | Konversi web dari browser dan sisi server. Angka hariannya tepat 1.000 × 86.400, jadi batas per detik adalah satu-satunya yang realistis bisa Anda capai. |
| App Events (/app/track/) dan /app/batch/ | 1.000 / detik · 600.000 / menit · 86.400.000 / hari | Konversi aplikasi seluler. |
| Offline Events (/offline/track/) dan /offline/batch/ | 1.000 / detik · 600.000 / menit · 86.400.000 / hari | Konversi di toko fisik dan CRM yang dikirim belakangan. |
| /event/track/ | 1.000 / detik · 600.000 / menit · 86.400.000 / hari | Endpoint Events API 2.0. |
| Streaming API | 10.000 / detik di Basic, hingga 50.000 di Ultimate | Satu-satunya batas di sisi events yang memang mengikuti tangga level. |
Kenapa memposting ke sepuluh akun tidak butuh waktu sepuluh kali lipat?
Karena setiap batas di atas berlaku per user access token, dan satu token adalah satu akun yang terhubung. Sepuluh akun berarti sepuluh wadah independen berisi enam posting per menit.
Yang membuat antre justru infrastruktur Anda sendiri: satu file video yang diunggah sepuluh kali berarti sepuluh transfer. Batas yang pertama kali terasa hampir tidak pernah milik TikTok, melainkan bandwidth.
Pertanyaan umum
- Apakah batas rate API TikTok berlaku per aplikasi atau per pengguna?
- Endpoint Content Posting didokumentasikan per user access token — jadi per akun yang terhubung. TikTok tidak memublikasikan batas terpisah untuk seluruh aplikasi pada endpoint ini, dan menyatakan bahwa batas ditetapkan dan diterapkan terpisah untuk setiap API.
- Error apa yang dikembalikan TikTok saat batas rate terlampaui?
- Status HTTP 429, dengan kode error rate_limit_exceeded di body respons.
- Bisakah batas rate API TikTok dinaikkan?
- Bisa. Dokumentasi TikTok menyatakan bahwa batas yang lebih tinggi bisa diminta lewat halaman dukungannya, dan setiap permintaan akan ditinjau.
- Berapa batas rate Events API TikTok per detik?
- 1.000 request per detik, 600.000 per menit, dan 86.400.000 per hari, sama untuk /event/track/, Web Events, App Events, dan Offline Events. TikTok menerapkan angka yang sama di keempat level aplikasi dan menyatakan Anda tidak perlu mengajukan kenaikan untuk Events API.
- Apakah batas rate Events API sama dengan batas rate Content Posting API?
- Tidak, dan keduanya bahkan bukan sistem yang sama. Content Posting didokumentasikan di developers.tiktok.com, dihitung per menit terhadap user access token, dan menjawab HTTP 429 dengan rate_limit_exceeded. Events API termasuk Marketing API di business-api.tiktok.com, dihitung dalam request per detik, menit, dan hari terhadap aplikasi developer Anda, dan menjawab dengan kode 40100.
- Berapa video TikTok yang bisa saya posting per menit lewat API?
- Enam per akun yang terhubung, karena endpoint Direct Post mengizinkan 6 request per menit per user access token. Untuk sepuluh akun yang terhubung, totalnya enam puluh, karena setiap akun punya batasnya sendiri.
Sumber
- TikTok for Developers — Rate Limits on API Requests — dibaca pada .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — dibaca pada .
- TikTok for Developers — Content Posting API, Direct Post — dibaca pada .
- TikTok for Developers — Query Creator Info — dibaca pada .
Angka-angka ini berasal dari dokumentasi perusahaan lain, yang bisa berubah tanpa pemberitahuan dan tidak diverifikasi otomatis oleh apa pun di sini. Karena itu setiap sumber mencantumkan tanggal dibacanya. Sumber di halaman ini dibaca ulang setiap kuartal.
Cara halaman ini dibuat: ditulis dengan bantuan AI dari sumber yang tercantum di halaman ini, dibaca pada .