Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok API ile video metrikleri: görüntülenme, izlenme süresi ve tamamlanma

TikTok API for Business, her gönderinin ömür boyu metriklerini GET /business/video/list/ uç noktasından döndürür. fields içinde adıyla istenen alanlar şunlardır: video_views, reach, likes, comments, shares ve favorites; saniye cinsinden total_time_watched ve average_time_watched; full_video_watched_rate, video_view_retention, impression_sources ve audience_countries gibi izleyici dökümleri. Sayıların çoğu 24 ila 48 saat gecikmeyle gelir ve yayınlanmasının üzerinden 365 gün geçtikten sonra güncellenmeyi durdurur.

easyCoexistence, Claude, ChatGPT veya kendi kodunuzdan get_social_insights ile bir TikTok videosunun metriklerini okur: video_views, reach ya da full_video_watched_rate gibi istediğiniz alanları adlandırın ve videonun item_id'sini verin.

video.insights

İzlenme süresi, tamamlanma, elde tutma, trafik kaynakları ve izleyici dökümleri için gereken kapsam; temel sayılar için video.list gerekir.

7 days

Erişim, izlenme süresi, trafik kaynakları ve audience_countries değerlerinin eksik kalabileceği hareketsizlik süresi.

10

Bir videonun audience_countries ve audience_cities listelerindeki girişlerin çoğu.

24 to 48 h

video_views, likes, reach, izlenme süresi ve trafik kaynakları için olağan gecikme, UTC cinsinden.

Bir videonun hangi metrikleri var?

GET /business/video/list/ uç noktası, fields içinde adı verilen her gönderi için bunları döndürür. Değerler, hesap metriklerinin 60 günlük penceresi yerine gönderinin tüm ömrü boyunca toplanmış değerlerdir. Görüntülenme ve beğeni gibi sayılar erişim token'ında video.list kapsamını gerektirir; izlenme, tamamlanma ve elde tutma rakamları ise video.insights kapsamını ister:

video_viewsViews, counted on the first playback in an impression session
reachPeople who watched the post at least once
likes, comments, sharesLifetime totals; shares include sends to friends inside TikTok
favoritesTimes the post was added to favorites
total_time_watchedSeconds viewers spent watching, in total
average_time_watchedAverage seconds viewers spent watching
full_video_watched_rateShare of viewers who finished the video
video_view_retentionShare of viewers still watching at each second
impression_sourcesWhere viewers found the post, by share
new_followersViewers who started following the account
engagement_likesShare of viewers who liked at each second
video_durationLength of the video in seconds

Bunları nasıl istersiniz?

Adları fields içinde, birden fazla alan listelendiğinde mutlaka item_id'yi içeren bir JSON dizisi olarak verin; gönderileri filters.video_ids ile seçin. Filtre olmadan uç nokta, hesabın gönderilerini en fazla 20'şer olacak şekilde sayfa sayfa gezer:

Metrics for one video
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","video_views","reach","video_duration","total_time_watched","average_time_watched","full_video_watched_rate","impression_sources","audience_countries"]' \
  --data-urlencode 'filters={"video_ids":["<ITEM_ID>"]}'

Yanıt nasıl görünür?

Her gönderi için bir nesne içeren bir videos dizisi ve sayfalama için cursor ile has_more alanları; istenen alanlar bu nesnelerde yer alır. TikTok'un kendi örneği, kısaltılmış hâliyle birimleri gösterir: izlenme süreleri üç ondalık basamağa kadar saniye cinsinden, full_video_watched_rate ise burada 0.0237 olan bir ondalık sayı olarak:

A video's metrics, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "2021080307532501024502410704A7306F",
  "data": {
    "videos": [
      {
        "item_id": "6990565363377392901",
        "video_views": 1231,
        "reach": 154,
        "likes": 10,
        "comments": 2,
        "shares": 0,
        "video_duration": 20.0,
        "total_time_watched": 695.942,
        "average_time_watched": 4.118,
        "full_video_watched_rate": 0.0237,
        "impression_sources": [
          { "impression_source": "For You", "percentage": 0.8983 },
          { "impression_source": "Personal Profile", "percentage": 0.0904 },
          { "impression_source": "Follow", "percentage": 0.0113 }
        ],
        "audience_countries": [
          { "country": "US", "percentage": 0.7574 },
          { "country": "GB", "percentage": 0.1775 }
        ]
      }
    ],
    "cursor": 0,
    "has_more": false
  }
}

Trafik kaynakları ne anlama geliyor?

impression_sources, gönderiyi izleyicilerin nerede keşfettiğini en büyük paydan en küçüğe doğru sıralar; her girdi bir impression_source olup yüzdesiyle birlikte gelir. TikTok bu değerleri şöyle belgeler:

  • For You: For You akışı.
  • Follow: Follow akışı.
  • Sound: ses sayfaları.
  • Personal Profile: profil sayfaları.
  • Search: arama sayfaları.
  • Direct Message: TikTok Studio hesap için bu veriyi gösterdiğinde doğrudan mesajlar.
  • Others: diğer her şey.

Hangi izleyici dökümleri var?

Dört tane var; hepsi hesabın takipçilerini değil, o gönderiyi izleyen kişileri tanımlar ve hepsi video.insights kapsamını gerektirir:

  • audience_genders: izleyicilerin cinsiyete göre payları, Female, Male veya Other.
  • audience_countries: ISO 3166-1 alpha-2 kodlarıyla en fazla 10 ülke veya bölge.
  • audience_cities: US Cincinnati biçiminde adlandırılmış en fazla 10 şehir.
  • audience_types: NEW_VIEWER ve RETURN_VIEWER, ayrıca FOLLOWER_PERCENT ile NON_FOLLOWER_PERCENT.

Hangi metrikler hesap türüne bağlı?

Birkaç tıklama ve profil ziyareti TikTok'un Business Analytics'inden gelir ve kişisel bir hesabın ötesinde bir hesap gerektirir. profile_views, yani bir gönderinin tetiklediği profil ziyaretleri, Advanced Access'li bir hesap veya Verified Business Account gerektirir. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks ve address_clicks ise Verified Business Account ister.

Bir metrik neden eksik veya geç olabilir?

Çünkü TikTok bunların çoğunu çevrimdışı hesaplar ve yalnızca TikTok Analytics'ten yararlanır. Sayılar ve izlenme metrikleri genellikle 24 ila 48 saat geride kalır; item_id, caption ve links ise gerçek zamanlı gelir. Erişim, izlenme süresi, trafik kaynakları ve audience_countries, 7 gündür kimsenin görüntülemediği, beğenmediği, yorumlamadığı veya paylaşmadığı bir video için eksik kalabilir. TikTok'un önerisi, videoyla etkileşime geçip 24 ila 48 saat sonra yeniden denemektir. Veriler yayınlanmasının üzerinden 365 gün geçtikten sonra güncellenmeyi durdurur; müzik telif hakkı gibi ihlaller nedeniyle filtrelenen gönderiler ise hiç döndürülmez.

easyCoexistence bir videonun metriklerini nasıl okur?

get_social_insights ile videonun item_id'sini object_id olarak, alan adlarını ise metrics olarak verirsiniz. Araç, hesabın en son 20 gönderisi arasında arayarak o gönderinin alanlarını döndürür. Daha eski bir gönderi için kendi kodunuz, get_social_credentials'tan aldığı token ile fields ve filters.video_ids parametreleriyle business/video/list/ uç noktasını çağırır.

One video's metrics through MCP
get_social_insights {
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<ITEM_ID>",
  "metrics": ["video_views", "reach", "average_time_watched", "full_video_watched_rate", "impression_sources"]
}

Yaygın hatalar

  • Her yüzde için tek bir ölçek varsaymak. TikTok'un örneklerinde impression_sources, toplamı 1 eden kesirler olarak verilir; audience_cities örneğinde ise 17.4921 gibi değerler görünür.
  • Birden fazla alanı item_id olmadan istemek. TikTok'un referansı, böyle bir isteğin başarısız olabileceği konusunda uyarır.
  • Eski ve sessiz bir videodan erişim beklemek. TikTok, 7 gün boyunca görüntülenme, beğeni, yorum veya paylaşım almayan bir videonun erişim, izlenme süresi ve trafik kaynaklarını boş bırakabilir.
  • Gönderi metriklerini günlük hesap metrikleriyle karşılaştırmak. Bir gönderinin rakamları tüm ömrünü kapsar; hesap metrikleri ise 60 güne kadar günlük olarak gelir.
Bunu EasyCoexistence'la yapmak

Daha eski gönderiler için get_social_credentials, kendi kodunuza hesabın token'ını verir. Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar düşer, bağlantı ekledikçe; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

TikTok API video başına izlenme süresi verir mi?

Evet. total_time_watched ve average_time_watched, video.insights kapsamına sahip token'lar için /business/video/list/ uç noktasından saniye cinsinden gelir.

TikTok API'si ile bir videonun tamamlanma oranını nasıl alırım?

/business/video/list/ üzerinde fields içinde full_video_watched_rate'i isteyin. TikTok bunu, videoyu sonuna kadar izleyen izleyicilerin yüzdesi olarak tanımlar.

TikTok videomda erişim ve izlenme süresi neden boş?

TikTok, son 7 günde görüntülenme, beğeni, yorum ya da paylaşımı olmayan bir video için bunları atlayabilir; yakın tarihli veriler de 24 ila 48 saat gecikir.

API belirli bir TikTok videosunun metriklerini döndürebilir mi?

Evet. Kimliğini filters.video_ids içinde geçirin; item_id ile istediğiniz metrikleri de fields içinde belirtin.

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