TikTok analytics API'si: hesap içgörüleri ve video metrikleri
TikTok'un API for Business'ı, bir hesabın metriklerini gün bazında döndürür: takipçi, video görüntüleme, profil görüntüleme, beğeni, yorum ve paylaşım, son 60 güne kadar. Her videonun toplam sayıları da gelir: görüntüleme, beğeni, yorum ve paylaşım. Çoğu sayı 24 ila 48 saat gecikmeli gelir ve bunlar, TikTok Analytics'in uygulamada açık olmasına bağlıdır.
easyCoexistence, Claude, ChatGPT veya kendi kodunuzdan get_social_insights ile TikTok içgörülerini okur: hesabın takipçi, görüntüleme ve beğenilerini gün bazında ya da bir videonun görüntüleme, beğeni, yorum ve paylaşımlarını.
Bir hesabın günlük metrikleri için en uzun geriye dönük süre; tarih verilmezse API son 7 günü döndürür.
Günlük ve gönderi başına sayıların, örneğin beğeni, görüntüleme ve paylaşımların, genellikle hazır olması için geçen süre.
Bir gönderinin verisinin güncellenmeyi durdurduğu, yayımlandıktan sonraki süre.
Bir hesabın takipçilerinin yaş, cinsiyet ve konum dağılımını TikTok'un döndürmesi için gereken takipçi sayısı.
Hangi hesap metrikleri var?
GET /business/get/ hesabın profilini ve istenen tarihler için gün başına bir girdi içeren bir metrik listesini UTC saatine göre döndürür:
followers_count: o anki toplam ve her gündeki toplam.video_views,profile_views, likes, comments ve shares: hesabın videoları genelinde günlük sayılar.unique_video_views,daily_new_followers,daily_lost_followersveengaged_audience: günlük; Advanced Access veya Verified Business Accounts hesapları için.audience_ages,audience_genders,audience_countriesveaudience_cities: takipçi dağılımları; en az 100 takipçisi olan hesaplar için.
Hangi video metrikleri var?
GET /business/video/list/ hesabın herkese açık gönderilerini ömür boyu sayılarla döndürür; 60 günlük geriye dönük sınırla sınırlı değildir: video_views, likes, comments, shares ve favorites; ayrıca erişim, toplam ve ortalama izlenme süresi, tam izlenme oranı, yeni takipçiler ve trafik kaynakları. Sayfa başına en fazla 20 gönderi döndürür; filters.video_ids belirli gönderileri seçer.
Veriler ne kadar güncel?
Hesap adı ve güncel takipçi toplamı gibi profil alanları gerçek zamanlıdır. Günlük hesap metrikleri ile görüntüleme, beğeni, yorum ve paylaşım gibi gönderi sayıları genellikle UTC saatine göre 24 ila 48 saat gecikir; bir gönderinin verisi yayımlandıktan 365 gün sonra güncellenmeyi durdurur. Erişim, izlenme süresi ve trafik kaynakları, 7 günden uzun süredir kimsenin izlemediği, beğenmediği, yorumlamadığı veya paylaşmadığı bir video için eksik olabilir.
Metrikler neden eksik olabilir?
API, TikTok Analytics'in sahip olduğunu döndürür. Hesap sahibinin en az bir video yayımlaması ve TikTok uygulamasında Analytics'i açması gerekir; Analytics açılmadan önceki veriler kullanılamaz. Bazı metrikler daha fazlasını gerektirir: erişilen kitle ile yeni veya kaybedilen takipçiler yalnızca Advanced Access veya Verified Business Accounts hesaplarında gelir, takipçi dağılımları ise 100 takipçiden başlar.
Sayılar neden TikTok uygulamasındakinden farklı olabilir?
Neyi içerdikleri yüzünden. video_views, organik ve ücretli görüntülemeleri birlikte sayar; shares ise TikTok dışındaki paylaşımları ve uygulama içinde arkadaşlara gönderilenleri birlikte sayar, bu yüzden TikTok'un web sitesindeki paylaşım sayısından yüksek görünebilir. Bir günün beğeni sayısı, sonradan geri alınan beğenileri düşmez.
easyCoexistence bunları nasıl okur?
get_social_insights ile. Hesap için, start_date ve end_date ile followers_count, video_views ve likes gibi metrikler isteyin; TikTok'un günlük satırlarını döndürür. Tek bir video için, item_id değerini object_id olarak verin; hesabın en son 20 videosu arasında arayarak görüntüleme, beğeni, yorum ve paylaşımları döndürür. Daha eski bir video için kendi kodunuz, get_social_credentials'tan aldığı token ile filters.video_ids parametresiyle business/video/list/ çağrısı yapar.
Yaygın hatalar
- Dünkü sayıları kesin sanmak. Günlük metrikler 24 ila 48 saat gecikebilir; bu yüzden son günler hâlâ dolmakta olabilir.
- Hesap metriklerinde 60 günden fazlasını istemek. Geriye dönük sınır orada biter; daha uzun bir geçmişe ihtiyacınız varsa sayıları kendiniz saklayın.
- Eski bir videoyu object_id ile aramak. get_social_insights en son 20 videoyu tarar; daha eski gönderiler için kendi kodunuzdan, get_social_credentials'tan aldığınız token ile video_ids üzerinden filtreleyin.
- API paylaşımlarını web sitesindeki sayıyla karşılaştırmak. API, TikTok içinde arkadaşlara gönderilenleri de sayar, bu yüzden değeri daha yüksek çıkar.
Diğer TikTok içgörü alanları için get_social_credentials, hesabın token'ını kendi kodunuza verir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
TikTok API'si bir hesabın kaybettiği takipçileri gösteriyor mu?
Evet; Advanced Access veya Verified Business Accounts hesaplarında daily_new_followers yanında daily_lost_followers olarak.
TikTok hesap içgörüleri ne kadar geriye gidiyor?
60 güne kadar. Tarih verilmezse API, UTC saatine göre isteğin yapıldığı günden bir önceki güne kadar olan 7 günü döndürür.
Bir TikTok videosunun verisi ne zaman güncellenmeyi durdurur?
Video yayımlandıktan 365 gün sonra. O zamana kadar ömür boyu sayıları güncellenmeye devam eder; genellikle 24 ila 48 saat gecikmeli olarak.
TikTok video görüntülemeleri ücretli görüntülemeleri içerir mi?
Evet. TikTok'un döndürdüğü video_views değeri, organik ve ücretli etkinliği birlikte kapsar.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi