Had Kadar Events API TikTok: 1,000 Permintaan/s (2026)
Kali terakhir disemak · sumber disenaraikan di bahagian bawah halaman ini
TikTok mengehadkan kadar setiap endpoint secara berasingan, berdasarkan tetingkap gelongsor satu minit. Endpoint Direct Post membenarkan 6 permintaan seminit bagi setiap user access token, Query Creator Info membenarkan 20, Get Post Status membenarkan 30, dan endpoint bacaan pengguna dan video (/v2/user/info/, /v2/video/query/, /v2/video/list/) masing-masing membenarkan 600. Jika melebihi had, API memulangkan HTTP 429 dengan kod ralat rate_limit_exceeded. Events API ialah sistem berasingan pada hos berasingan: 1,000 permintaan sesaat, sama pada setiap tahap aplikasi, dan menjawab dengan kod 40100 apabila dihadkan.
Berapakah had kadar bagi setiap endpoint API TikTok?
Had ditetapkan dan dikuatkuasakan bagi setiap endpoint, bukan sebagai satu bajet yang dikongsi. Menghabiskan had Direct Post tidak melambatkan Get Post Status, dan begitu juga sebaliknya.
| Endpoint | Had | Maksudnya dalam amalan |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 permintaan / minit bagi setiap user access token | Had yang paling mengikat bagi sesiapa yang menyiarkan ke beberapa akaun. Ia bagi setiap token, jadi bagi setiap akaun yang disambungkan — sepuluh akaun tidak berkongsi enam permintaan, setiap satu mempunyai enam. |
| Query Creator Info | 20 permintaan / minit bagi setiap user access token | Dipanggil sebelum setiap siaran, kerana UI penyiaran wajib memaparkan pilihan privasi sebenar pencipta. Sebab itu satu aliran penerbitan memerlukan sekurang-kurangnya dua panggilan, bukan satu. |
| Get Post Status | 30 permintaan / minit bagi setiap user access token | Tinjauan berkala (polling). Tiga puluh seminit kedengaran banyak sehingga anda meninjau sepuluh akaun setiap dua saat — itu 300. |
| /v2/user/info/ | 600 permintaan / minit | Bacaan profil. |
| /v2/video/query/ | 600 permintaan / minit | Metrik untuk video tertentu. |
| /v2/video/list/ | 600 permintaan / minit | Senarai video pencipta, mengikut halaman. |
Bagaimanakah tetingkap dikira, dan apa yang berlaku jika anda melebihinya?
Pengiraan menggunakan tetingkap gelongsor satu minit, bukan minit jam yang tetap. Lonjakan enam siaran pada 10:00:59 tidak ditetapkan semula pada 10:01:00 — ia terus dikira sehingga 10:01:59.
Melepasi ambang, API menjawab HTTP 429 dengan kod ralat rate_limit_exceeded. TikTok menyatakan bahawa had boleh dinaikkan atas permintaan melalui halaman sokongannya, disemak kes demi kes.
Akibat praktikal bagi penerbit berbilang akaun: cubaan semula selepas 429 mesti berundur dahulu, bukan terus mengulang. Cubaan semula serta-merta memanjangkan tetingkap yang cuba dielakkan.
Berapakah had kadar Events API TikTok, dalam permintaan sesaat?
Seribu sesaat, dan angkanya sama untuk setiap aplikasi pembangun — inilah satu-satunya tempat TikTok tidak memaksa anda memohon had yang lebih tinggi.
Ini API yang berbeza daripada setiap endpoint di atas, dan bahagian inilah yang sering mengelirukan. Endpoint Content Posting berada di developers.tiktok.com dan dikira seminit, bagi setiap user access token. Events API ialah sebahagian daripada Marketing API di business-api.tiktok.com, dan dikira dalam QPS, QPM dan QPD terhadap aplikasi pembangun anda. Dua hos, dua sistem, dua kod ralat: Marketing API menjawab "code": 40100 manakala API pembangun menjawab HTTP 429.
Aplikasi anda juga berada pada salah satu daripada empat tahap global — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, dan setiap aplikasi bermula pada Basic. Endpoint Events dikecualikan secara jelas daripada tangga itu: TikTok menyatakan anda tidak perlu memohon perubahan tahap had kadar untuk Events API, kerana hadnya sama untuk semua tahap. Jadi 1,000 QPS di bawah ialah apa yang diperoleh aplikasi baharu sejak hari pertama.
| Endpoint | Had | Maksudnya dalam amalan |
|---|---|---|
| Web Events (/pixel/track/) dan /pixel/batch/ | 1,000 / saat · 600,000 / minit · 86,400,000 / hari | Penukaran web daripada pelayar dan sisi pelayan. Angka hariannya tepat 1,000 × 86,400, jadi had sesaat ialah satu-satunya yang realistik boleh anda capai. |
| App Events (/app/track/) dan /app/batch/ | 1,000 / saat · 600,000 / minit · 86,400,000 / hari | Penukaran aplikasi mudah alih. |
| Offline Events (/offline/track/) dan /offline/batch/ | 1,000 / saat · 600,000 / minit · 86,400,000 / hari | Penukaran di kedai fizikal dan CRM yang dihantar kemudian. |
| /event/track/ | 1,000 / saat · 600,000 / minit · 86,400,000 / hari | Endpoint Events API 2.0. |
| Streaming API | 10,000 / saat pada Basic, sehingga 50,000 pada Ultimate | Satu-satunya had di sisi events yang memang mengikut tangga tahap. |
Mengapa menyiarkan ke sepuluh akaun tidak mengambil masa sepuluh kali ganda?
Kerana setiap had di atas terikat pada user access token, dan satu token ialah satu akaun yang disambungkan. Sepuluh akaun ialah sepuluh baldi bebas yang masing-masing berisi enam siaran seminit.
Yang membuatkan proses beratur ialah infrastruktur anda sendiri: satu fail video yang dimuat naik sepuluh kali ialah sepuluh pemindahan. Had yang pertama terasa hampir tidak pernah milik TikTok, sebaliknya lebar jalur.
Soalan lazim
- Adakah had kadar API TikTok bagi setiap aplikasi atau setiap pengguna?
- Endpoint Content Posting didokumenkan bagi setiap user access token — jadi bagi setiap akaun yang disambungkan. TikTok tidak menerbitkan had berasingan untuk seluruh aplikasi bagi endpoint ini, dan menyatakan bahawa had ditetapkan dan dikuatkuasakan secara berasingan untuk setiap API.
- Apakah ralat yang dipulangkan TikTok apabila had kadar dilampaui?
- Status HTTP 429, dengan kod ralat rate_limit_exceeded dalam badan respons.
- Bolehkah had kadar API TikTok dinaikkan?
- Boleh. Dokumentasi TikTok menyatakan had yang lebih tinggi boleh dipohon melalui halaman sokongannya, dan setiap permohonan akan disemak.
- Berapakah had kadar Events API TikTok sesaat?
- 1,000 permintaan sesaat, 600,000 seminit dan 86,400,000 sehari, sama bagi /event/track/, Web Events, App Events dan Offline Events. TikTok menggunakan angka yang sama pada keempat-empat tahap aplikasi dan menyatakan anda tidak perlu memohon kenaikan untuk Events API.
- Adakah had kadar Events API sama dengan had kadar Content Posting API?
- Tidak, malah kedua-duanya bukan sistem yang sama. Content Posting didokumenkan di developers.tiktok.com, dikira seminit terhadap user access token, dan menjawab HTTP 429 dengan rate_limit_exceeded. Events API tergolong dalam Marketing API di business-api.tiktok.com, dikira dalam permintaan sesaat, seminit dan sehari terhadap aplikasi pembangun anda, dan menjawab dengan kod 40100.
- Berapa banyak video TikTok yang boleh saya siarkan seminit melalui API?
- Enam bagi setiap akaun yang disambungkan, kerana endpoint Direct Post membenarkan 6 permintaan seminit bagi setiap user access token. Untuk sepuluh akaun yang disambungkan, jumlahnya enam puluh, kerana setiap akaun membawa hadnya 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 datang daripada dokumentasi syarikat lain, yang boleh berubah tanpa notis dan tidak disahkan secara automatik oleh apa-apa di sini. Sebab itu setiap sumber membawa tarikh ia dibaca. Sumber di halaman ini dibaca semula setiap suku tahun.
Cara halaman ini dihasilkan: ditulis dengan bantuan AI daripada sumber yang disenaraikan di halaman ini, dibaca pada .