TikTok Events API sınırı: saniyede 1.000 istek (2026)
Son kontrol: · kaynaklar bu sayfanın en altında listelenmiştir
TikTok her uç noktayı ayrı ayrı, bir dakikalık kayan pencereye göre sınırlar. Direct Post uç noktası kullanıcı erişim belirteci başına dakikada 6 isteğe, Query Creator Info 20’ye, Get Post Status 30’a, kullanıcı ve video okuma uç noktaları (/v2/user/info/, /v2/video/query/, /v2/video/list/) ise her biri 600’e izin verir. Sınırı aşmak rate_limit_exceeded hata koduyla HTTP 429 döndürür. Events API ayrı bir sunucuda çalışan ayrı bir sistemdir: saniyede 1.000 istek, her uygulama seviyesinde aynı; kısıtlandığında 40100 koduyla yanıt verir.
Her TikTok API uç noktasının istek sınırı nedir?
Sınırlar tek bir ortak bütçe olarak değil, uç nokta bazında belirlenir ve uygulanır. Direct Post’u tüketmek Get Post Status’u yavaşlatmaz; tersi de geçerli.
| Uç nokta | Sınır | Pratikte anlamı |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | Kullanıcı erişim belirteci başına 6 istek / dakika | Birden çok hesaba yayın yapan herkes için belirleyici sınır. Belirteç başınadır, yani bağlı hesap başına — on hesap altı isteği paylaşmaz, her birinin altı hakkı vardır. |
| Query Creator Info | Kullanıcı erişim belirteci başına 20 istek / dakika | Her paylaşımdan önce çağrılır, çünkü yayın arayüzü içerik üreticisinin gerçek gizlilik seçeneklerini göstermek zorundadır. Bir yayın akışının bir değil en az iki çağrıya mal olmasının nedeni budur. |
| Get Post Status | Kullanıcı erişim belirteci başına 30 istek / dakika | Yoklama. Dakikada otuz, on hesabı iki saniyede bir yoklayana kadar cömert görünür — bu 300 eder. |
| /v2/user/info/ | 600 istek / dakika | Profil okumaları. |
| /v2/video/query/ | 600 istek / dakika | Belirli videoların metrikleri. |
| /v2/video/list/ | 600 istek / dakika | Bir içerik üreticisinin videolarının sayfalı listesi. |
Pencere nasıl hesaplanır ve aşıldığında ne olur?
Hesaplama sabit bir saat dakikası değil, bir dakikalık kayan pencere kullanır. 10:00:59’da yapılan altı paylaşımlık bir patlama 10:01:00’de sıfırlanmaz — 10:01:59’a kadar sayılmaya devam eder.
Eşiğin üzerinde API, rate_limit_exceeded hata koduyla HTTP 429 döner. TikTok, sınırların destek sayfası üzerinden talep edilerek artırılabileceğini ve her talebin ayrı ayrı değerlendirildiğini belirtir.
Çok hesaplı yayıncı için pratik sonuç: 429 sonrası yeniden deneme hemen tekrarlamamalı, geri çekilip beklemelidir. Anında yeniden deneme, kaçmaya çalıştığı pencereyi uzatır.
TikTok Events API’nin saniye başına istek sınırı nedir?
Saniyede bin ve bu sayı her geliştirici uygulaması için aynıdır — TikTok’un daha fazlası için başvurmanı istemediği tek yer burası.
Bu, yukarıdaki tüm uç noktalardan farklı bir API’dir ve insanların takıldığı nokta da tam olarak bu. Content Posting uç noktaları developers.tiktok.com’dadır ve dakika başına, kullanıcı erişim belirteci başına sayılır. Events API ise business-api.tiktok.com’daki Marketing API’nin bir parçasıdır ve geliştirici uygulamana göre QPS, QPM ve QPD cinsinden sayılır. İki sunucu, iki sistem, iki hata kodu: geliştirici API’si HTTP 429 dönerken Marketing API "code": 40100 döner.
Uygulaman ayrıca dört genel seviyeden birinde yer alır — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50 ve her uygulama Basic’ten başlar. Events uç noktaları bu merdivenden açıkça muaftır: TikTok, sınır tüm seviyelerde aynı olduğu için Events API için seviye değişikliğine başvurman gerekmediğini belirtir. Yani aşağıdaki 1.000 QPS, yepyeni bir uygulamanın ilk gününden aldığı değerdir.
| Uç nokta | Sınır | Pratikte anlamı |
|---|---|---|
| Web Events (/pixel/track/) ve /pixel/batch/ | 1.000 / saniye · 600.000 / dakika · 86.400.000 / gün | Tarayıcı ve sunucu taraflı web dönüşümleri. Günlük rakam tam olarak 1.000 × 86.400’dür, yani gerçekçi olarak ulaşabileceğin tek sınır saniye başına olanıdır. |
| App Events (/app/track/) ve /app/batch/ | 1.000 / saniye · 600.000 / dakika · 86.400.000 / gün | Mobil uygulama dönüşümleri. |
| Offline Events (/offline/track/) ve /offline/batch/ | 1.000 / saniye · 600.000 / dakika · 86.400.000 / gün | Sonradan gönderilen mağaza içi ve CRM dönüşümleri. |
| /event/track/ | 1.000 / saniye · 600.000 / dakika · 86.400.000 / gün | Events API 2.0 uç noktası. |
| Streaming API | Basic’te 10.000 / saniye, Ultimate’te 50.000’e kadar | Olaylar tarafında seviye merdivenini gerçekten izleyen tek sınır. |
On hesaba yayın yapmak neden on kat uzun sürmez?
Çünkü yukarıdaki her sınır bir kullanıcı erişim belirtecine bağlıdır ve bir belirteç bir bağlı hesaptır. On hesap, dakikada altı paylaşımlık on bağımsız kovadır.
Sıraya giren şey kendi altyapındır: on kez yüklenen bir video dosyası on aktarım demektir. İlk takılan sınır neredeyse hiçbir zaman TikTok’unki değil, bant genişliğidir.
Sık sorulan sorular
- TikTok API istek sınırları uygulama başına mı, kullanıcı başına mı?
- Content Posting uç noktaları kullanıcı erişim belirteci başına, yani bağlı hesap başına belgelenmiştir. TikTok bu uç noktalar için ayrı bir uygulama geneli tavan yayımlamaz ve sınırların her API için ayrı ayrı belirlenip uygulandığını belirtir.
- İstek sınırı aşıldığında TikTok hangi hatayı döndürür?
- HTTP 429 durum kodu, yanıt gövdesinde rate_limit_exceeded hata koduyla.
- TikTok API istek sınırları artırılabilir mi?
- Evet. TikTok’un dokümantasyonu, daha yüksek sınırların destek sayfası üzerinden talep edilebileceğini ve her talebin incelendiğini belirtir.
- TikTok Events API’nin saniye başına sınırı nedir?
- /event/track/, Web Events, App Events ve Offline Events için aynı şekilde saniyede 1.000, dakikada 600.000 ve günde 86.400.000 istek. TikTok dört uygulama seviyesinin hepsinde aynı rakamı uygular ve Events API için artış talep etmen gerekmediğini belirtir.
- Events API sınırı Content Posting API sınırıyla aynı mı?
- Hayır, hatta aynı sistem bile değiller. Content Posting developers.tiktok.com’da belgelenir, kullanıcı erişim belirtecine göre dakika başına sayılır ve rate_limit_exceeded ile HTTP 429 döner. Events API ise business-api.tiktok.com’daki Marketing API’ye aittir, geliştirici uygulamana göre saniye, dakika ve gün başına istek olarak sayılır ve 40100 kodunu döner.
- API üzerinden dakikada kaç TikTok videosu paylaşabilirim?
- Bağlı hesap başına altı, çünkü Direct Post uç noktası kullanıcı erişim belirteci başına dakikada 6 isteğe izin verir. On bağlı hesapta bu altmış eder, çünkü her hesabın kendi sınırı vardır.
Kaynaklar
- TikTok for Developers — Rate Limits on API Requests — okunma tarihi: .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — okunma tarihi: .
- TikTok for Developers — Content Posting API, Direct Post — okunma tarihi: .
- TikTok for Developers — Query Creator Info — okunma tarihi: .
Bu rakamlar başka bir şirketin dokümantasyonundan geliyor; bu dokümantasyon haber verilmeden değişebilir ve buradaki hiçbir şey onu otomatik olarak doğrulamaz. Bu yüzden her kaynak okunduğu tarihi taşır. Bu sayfadaki kaynaklar her çeyrekte yeniden okunur.
Bu sayfa nasıl hazırlandı: bu sayfada listelenen kaynaklardan yapay zekâ yardımıyla yazıldı; kaynakların okunduğu tarih: .