Son güncelleme
Krediler
Her çalışma alanının, her faturalandırma döneminde yeniden dolan bir kredi cüzdanı vardır. API çağrıları ve panel okumaları aynı cüzdandan harcar; referans, her işlemin sınıfını listeler.
Bir işlemin maliyeti
| Sınıf | Çağrı başına kredi | Kapsadığı işlemler |
|---|---|---|
| Önbellekten okuma | 1 | Saklanan verilerin her okuması: sıralamalar, içerik üreticileri, içgörüler, videolar, yorumlar, trendler, LIVE oturumları. API anahtarlarını listelemek (GET /v1/api-keys) de bir önbellekten okumadır. |
| Takip edilen / takipçi listesi | 4,000 | Liste yeniden toplanmak zorunda kaldığında GET /v1/creators/{uid}/following veya /followers (1 yerine). |
| Yorumlar | 500 | Yorumlar yeniden toplanmak zorunda kaldığında GET /v1/videos/{id}/comments (1 yerine). |
| Profil çözümleme | 1,250 | Güncelliğini yitirmiş bir profil yeniden çözümlendiğinde GET /v1/creators/{uid}, okumaya ek olarak. Yalnızca bir profil döndüğünde ücretlendirilir. |
| Canlı yenileme | 1,250 | POST /v1/live/creators/{uid}/refresh: worker’lardan bir içerik üreticisini hemen kontrol etmelerini isteyin. |
| Dışa aktarma | 2,500 | POST /v1/exports: bir CSV veya Excel dosyası oluşturur. |
| Webhook teslimatı | 1 | Bir uyarı kuralının teslim ettiği her webhook, kural testinin gönderdiği dahil. |
| Ücretsiz | 0 | Uyarı kurallarını yönetme, dışa aktarmaları listeleme ve indirme, anahtar oluşturma ve iptal etme, plan hakları ve kullanım. |
Referanstaki her işlem, sınıfını kapsamının yanında gösterir. Bir 202 yanıtı (toplama hâlâ sürüyor) önbellekten okuma olarak ücretlendirilir.
Aylık kota
Her takvim ayında (UTC), çalışma alanının planı kotasını ayın ilk ölçülen çağrısında veya ilk cüzdan okumasında tanımlar. Bir aydaki harcama kotayı aşamaz. Planlar için fiyatlandırma sayfasına bakın.
| Plan | Aylık kredi |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
Cüzdan boşaldığında
Tavanı aşacak ölçülen bir çağrı, alışılmış hata zarfı içinde credit_cap_exceeded koduyla 402 döndürür. Ücretsiz işlemler çalışmaya devam eder. Cüzdan bir sonraki ayın başında yeniden dolar; ay ortasında plan yükseltmek tavanı artırır.
4xx veya 5xx yanıtının maliyeti yoktur. Bir 2xx veya 3xx ücretlendirilir.Cüzdanı okuyun
GET /v1/entitlements, mevcut dönemin planını, limitlerini ve cüzdanını döndürür; GET /v1/usage harcamayı işleme göre ayrıntılandırır. İkisi de ücretsizdir ve keys:manage kapsamını gerektirir.
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }