Terakhir diperbarui
Kredit
Setiap workspace memiliki dompet kredit yang terisi ulang setiap periode penagihan. Panggilan API dan pembacaan di dashboard mengambil dari dompet yang sama; referensi mencantumkan kelas setiap operasi.
Biaya sebuah operasi
| Kelas | Kredit per panggilan | Mencakup |
|---|---|---|
| Baca cache | 1 | Setiap pembacaan data yang tersimpan: peringkat, kreator, insight, video, komentar, tren, sesi LIVE. Menampilkan daftar API key (GET /v1/api-keys) juga termasuk baca cache. |
| Daftar follow | 4,000 | GET /v1/creators/{uid}/following atau /followers saat daftarnya harus dikumpulkan dari awal (bukan 1). |
| Komentar | 500 | GET /v1/videos/{id}/comments saat komentarnya harus dikumpulkan dari awal (bukan 1). |
| Resolusi profil | 1,250 | GET /v1/creators/{uid} saat profil yang usang di-resolve ulang, di luar biaya pembacaan. Hanya dikenakan jika profil berhasil didapat. |
| Refresh live | 1,250 | POST /v1/live/creators/{uid}/refresh: meminta worker memeriksa seorang kreator sekarang juga. |
| Ekspor | 2,500 | POST /v1/exports: membuat file CSV atau Excel. |
| Pengiriman webhook | 1 | Setiap webhook yang dikirim oleh aturan peringatan, termasuk yang dikirim oleh uji aturan. |
| Gratis | 0 | Mengelola aturan peringatan, menampilkan daftar dan mengunduh ekspor, membuat dan mencabut key, hak akses, dan pemakaian. |
Setiap operasi di referensi menampilkan kelasnya di samping scope-nya. Jawaban 202 (pengumpulan masih berjalan) ditagih sebagai baca cache.
Jatah bulanan
Setiap bulan kalender (UTC), paket workspace memberikan jatahnya pada panggilan berbayar atau pembacaan dompet pertama di bulan itu. Pemakaian dalam sebulan tidak dapat melewati jatah tersebut. Lihat harga untuk daftar paket.
| Paket | Kredit per bulan |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
Saat dompet kosong
Panggilan berbayar yang akan melewati batas menjawab 402 dengan kode credit_cap_exceeded dalam amplop error yang biasa. Operasi gratis tetap berjalan. Dompet terisi ulang di awal bulan berikutnya; upgrade di tengah bulan menaikkan batasnya.
4xx atau 5xx tidak dikenai biaya. Jawaban 2xx atau 3xx ditagih.Membaca dompet
GET /v1/entitlements mengembalikan paket, batas, dan dompet periode berjalan; GET /v1/usage merinci pemakaian per operasi. Keduanya gratis dan memerlukan scope keys:manage.
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }