Pembatasan laju API TikTok: permintaan per akun, aplikasi, dan endpoint
API for Business TikTok membatasi panggilan di tiga level sekaligus: 40 per menit per akun yang diberi otorisasi di setiap endpoint Accounts API, anggaran gabungan Accounts API per aplikasi developer sebesar 600 per menit di Basic dan 1,000 di atasnya, serta batas per endpoint untuk aplikasi sebesar 10 per detik, 600 per menit, dan 864,000 per hari di Basic, naik menjadi 50 per detik di Ultimate.
easyCoexistence mempublikasikan postingan, membaca insight, dan membalas komentar di TikTok untuk Claude, ChatGPT, atau kode Anda sendiri melalui API for Business TikTok, mengembalikan kode dan pesan TikTok saat panggilan dibatasi, serta mengikuti setiap postingan sampai TikTok menyelesaikan atau menggagalkannya.
Kueri per menit per akun TikTok yang diberi otorisasi di setiap endpoint Accounts API, satu angka terpisah dari level aplikasi.
Anggaran untuk semua endpoint Accounts API digabung per aplikasi developer pada Advanced, Premium, dan Ultimate; Basic mendapat 600.
Batas per endpoint di Ultimate, level aplikasi tertinggi, bersama 3,000 kueri per menit dan 4,320,000 per hari.
Status yang dikembalikan TikTok bersama kode responsnya, termasuk kode 4xxxx seperti 40100; hanya kode 0 yang berarti berhasil.
Pembatasan laju untuk setiap endpoint Discovery API per aplikasi developer.
Kapan batas harian direset; setelah batas per menit, TikTok meminta jeda 5 menit sebagai gantinya.
Batas mana yang berlaku untuk satu panggilan API TikTok?
Hingga tiga penghitung bergerak setiap kali ada panggilan Accounts API, dan beberapa produk serta tindakan memiliki hitungannya sendiri. TikTok menjaga penghitung endpoint tetap independen, sehingga satu endpoint bisa dibatasi sementara endpoint lain pada aplikasi yang sama tetap merespons:
Apa yang diizinkan oleh keempat level aplikasi?
Semua aplikasi developer dimulai di Basic, dan TikTok menaikkan aplikasi satu level setiap kali diminta lewat My Apps, App Detail, Authorization, dengan alasan. Setiap level menentukan berapa banyak yang bisa diambil satu endpoint dari aplikasi, di samping anggaran gabungan untuk panggilan Accounts API:
Apakah level yang lebih tinggi menaikkan anggaran Accounts API?
Hanya sekali. Berpindah dari Basic ke Advanced menaikkan anggaran gabungan Accounts API dari 600 menjadi 1,000 kueri per menit, dan tetap di 1,000 melalui Premium dan Ultimate, sementara batas per endpoint per detik dan per hari terus naik. Batas 40 per menit per akun dan endpoint tidak berubah sama sekali dengan level, sehingga satu akun yang sibuk akan dibatasi di 40 panggilan per menit pada sebuah endpoint, apa pun level yang dimiliki aplikasi.
Bagaimana batas dihitung untuk banyak akun?
Batas akun dikalikan untuk setiap akun; anggaran aplikasi tidak. Sepuluh akun masing-masing bisa membuat 40 panggilan per menit ke /business/comment/list/, totalnya 400, tetapi dua puluh akun yang melakukan hal yang sama membutuhkan 800, di atas 600 yang dimiliki aplikasi Basic untuk panggilan Accounts API secara gabungan sebelum endpoint lain dihitung. Di atas Basic, anggaran bersama itu mentok di 1,000 per menit.
Apa yang terjadi saat panggilan melewati batas?
TikTok membatasi endpoint tersebut. Panduan rate limits-nya menyebut kode 40100 untuk panggilan yang dibatasi, yang muncul di dalam body respons HTTP 200, dan endpoint tetap tertutup selama 5 menit setelah batas per menit, atau sampai penghitung harian direset pukul 00:00 UTC setelah batas harian, sementara endpoint lain pada aplikasi tetap merespons. Mendeteksinya di kode dan mencoba kembali dengan baik menjadi urusan kesalahan 40100.
Apakah batas publikasi termasuk pembatasan laju?
Tidak, batas itu menghitung postingan, bukan panggilan, dan punya halamannya sendiri. TikTok memungkinkan sebuah akun mempublikasikan enam postingan per menit dan 15 per hari melalui /business/video/publish/, dan jumlah yang sama melalui /business/photo/publish/. Postingan yang melebihi jumlah itu gagal dengan spam_risk_too_many_posts di status publikasinya, sedangkan batas permintaan menolak panggilannya sendiri.
Kebiasaan apa yang paling cepat menghabiskan batas?
Polling. Memeriksa status publikasi atau daftar komentar dengan timer menghabiskan 40 panggilan per menit akun pada endpoint itu, baik ada perubahan atau tidak, dan webhook TikTok ada untuk menggantikannya: event publikasi postingan melaporkan setiap tahap postingan, dan comment.update melaporkan komentar baru dalam lima menit. Membaca per halaman, 20 postingan atau 30 komentar per panggilan, dan mengambil mention sekali sehari menjaga sisanya tetap rendah.
Bagaimana easyCoexistence menangani panggilan TikTok yang dibatasi?
Ia meneruskan jawaban TikTok alih-alih menyembunyikannya. Panggilan alat yang dibatasi TikTok, seperti list_social_comments, reply_to_comment, atau get_tiktok_publish_status, kembali ke AI sebagai kesalahan yang menyebut kode 40100 beserta pesan TikTok, dan tidak diulang sendiri. Postingan mengambil jalur berbeda, karena publish_tiktok_post menyerahkan setiap postingan ke antrean easyCoexistence, sekarang atau pada waktu yang ditentukan:
- Antrean menunggu dan mencoba lagi setelah 5 menit, 30 menit, dan 2 jam ketika jawaban kembali sebagai HTTP 429.
- TikTok mengirim 40100 di dalam jawaban HTTP 200, jadi publikasi TikTok yang dibatasi gagal dengan pesan TikTok dan menunggu di bawah Needs attention untuk Retry.
- 40100 pada salah satu pemeriksaan status antrean juga menggagalkan postingan, meskipun TikTok mungkin sudah memublikasikannya: periksa postingan terbaru akun sebelum Retry.
- Postingan yang gagal di latar belakang mengirim email ke pemilik, paling banyak sekali per saluran setiap 3 jam.
Panggilan TikTok apa saja yang dibuat easyCoexistence untuk sebuah akun?
Beberapa, dan panggilan ini dihitung terhadap batas akun seperti panggilan Anda sendiri:
- /business/get/ sekitar setiap 6 jam, untuk memastikan akun masih merespons.
- Satu panggilan publikasi per postingan, lalu /business/publish/status/ sekitar setiap 20 detik sampai TikTok menyelesaikan atau menggagalkan postingan, hingga 2 jam.
- Jika aturan komentar atau otomasi aktif, satu panggilan /business/comment/list/ untuk setiap komentar tingkat atas baru guna membaca penulisnya, dan satu panggilan untuk setiap balasan yang diposting.
- Panggilan alat hanya saat AI atau kode Anda memintanya, dengan 20 postingan atau 30 komentar per pembacaan.
Kesalahan umum
- Mendeteksi pembatasan dari status HTTP. TikTok menjawab 40100 dengan HTTP 200, jadi pemeriksaan pada res.ok atau pada 429 akan melewatkannya; baca kode di dalam body.
- Menaikkan level aplikasi untuk memperbaiki satu akun yang sibuk. Batas 40 per menit per akun dan endpoint tetap sama di keempat level, jadi sebarkan panggilan akun tersebut dari waktu ke waktu.
- Mengambil data Mentions berkali-kali sehari. TikTok memperbaruinya sekali, antara tengah malam dan pukul 7 pagi UTC, dan menyarankan satu panggilan per endpoint dan akun per hari.
Dari US$ 9 turun hingga US$ 0.75 per koneksi per bulan, makin murah seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Berapa pembatasan laju API TikTok per akun?
40 kueri per menit di setiap endpoint Accounts API untuk setiap akun TikTok yang diberi otorisasi, di dalam anggaran gabungan aplikasi developer sebesar 600 per menit di Basic atau 1,000 di atasnya.
Apakah pembatasan laju TikTok dihitung per endpoint?
Ya. Panduan TikTok menyebut batas khusus endpoint bersifat independen, sehingga mencapai batas satu endpoint tidak menghentikan panggilan ke endpoint lain.
Bagaimana cara menaikkan pembatasan laju API TikTok saya?
Ajukan di My Apps, App Detail, Authorization dan sertakan alasan. Level naik satu langkah sekali, dari Basic ke Advanced, lalu Premium, kemudian Ultimate.
Apakah panggilan lewat easyCoexistence dihitung terhadap batas TikTok?
Ya. Panggilan itu berjalan sebagai akun terhubung dengan tokennya, sehingga dihitung terhadap 40 panggilan per menit per endpoint seperti panggilan lain untuk akun tersebut.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada