Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Metrik video TikTok melalui API: tontonan, masa tontonan dan kadar tontonan penuh

API for Business TikTok memulangkan metrik sepanjang hayat bagi setiap hantaran daripada GET /business/video/list/, diminta mengikut nama dalam fields: video_views, reach, likes, comments, shares dan favorites, total_time_watched dan average_time_watched dalam saat, full_video_watched_rate, video_view_retention, impression_sources serta pecahan penonton seperti audience_countries. Kebanyakan kiraan tiba lewat 24 hingga 48 jam dan berhenti dikemas kini 365 hari selepas diterbitkan.

easyCoexistence membaca metrik video TikTok dengan get_social_insights daripada Claude, ChatGPT atau kod anda sendiri: nyatakan medan yang anda mahu, seperti video_views, reach atau full_video_watched_rate, dan beri item_id video.

video.insights

Skop yang diperlukan untuk masa tontonan, penyiapan, pengekalan, sumber trafik dan pecahan penonton; kiraan asas memerlukan video.list.

7 days

Tempoh tidak aktif selepas itu capaian, masa tontonan, sumber trafik dan audience_countries boleh hilang bagi sesebuah video.

10

Kebanyakan entri dalam senarai audience_countries dan audience_cities bagi sesebuah video.

24 to 48 h

Kelewatan biasa bagi video_views, likes, reach, masa tontonan dan sumber trafik, dalam UTC.

Apakah metrik yang ada pada sesebuah video?

GET /business/video/list/ memulangkan ini bagi setiap hantaran yang dinyatakan dalam fields, dikumpulkan sepanjang hayat hantaran itu dan bukan tetingkap 60 hari bagi metrik akaun. Kiraan seperti tontonan dan suka memerlukan skop video.list pada token, manakala angka tontonan, penyiapan dan pengekalan memerlukan video.insights:

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

Bagaimana anda memintanya?

Nyatakan dalam fields, tatasusunan JSON yang mesti termasuk item_id apabila senarai itu mengandungi lebih daripada satu medan, dan pilih hantaran dengan filters.video_ids. Tanpa penapis, endpoint itu menyemak hantaran akaun halaman demi halaman, sehingga 20 sekali gus:

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>"]}'

Bagaimanakah rupa respons?

Tatasusunan videos dengan satu objek bagi setiap hantaran dan medan yang diminta, serta cursor dan has_more untuk penomboran halaman. Contoh TikTok sendiri, dipendekkan, menunjukkan unitnya: masa tontonan dalam saat dengan sehingga tiga titik perpuluhan, dan full_video_watched_rate sebagai perpuluhan, 0.0237 di sini:

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
  }
}

Apakah maksud sumber trafik?

impression_sources menyusun tempat penonton menemui hantaran itu, daripada bahagian terbesar kepada terkecil, dengan setiap entri ialah impression_source beserta peratusannya. TikTok mendokumentasikan nilai-nilai ini:

  • For You: suapan For You.
  • Follow: suapan Follow.
  • Sound: halaman bunyi.
  • Personal Profile: halaman profil peribadi.
  • Search: halaman carian.
  • Direct Message: mesej langsung, apabila TikTok Studio menunjukkan data itu untuk akaun.
  • Others: segala yang lain.

Pecahan penonton yang mana ada?

Empat, kesemuanya menggambarkan orang yang menonton hantaran itu dan bukan pengikut akaun, dan kesemuanya memerlukan video.insights:

  • audience_genders: bahagian penonton mengikut jantina, Female, Male atau Other.
  • audience_countries: sehingga 10 negara atau wilayah, dalam kod ISO 3166-1 alpha-2.
  • audience_cities: sehingga 10 bandar, dinamakan seperti US Cincinnati.
  • audience_types: NEW_VIEWER dan RETURN_VIEWER, serta FOLLOWER_PERCENT berbanding NON_FOLLOWER_PERCENT.

Metrik mana yang bergantung pada jenis akaun?

Beberapa klik dan lawatan profil datang daripada Business Analytics TikTok dan memerlukan lebih daripada akaun peribadi. profile_views, lawatan profil yang didorong oleh hantaran, memerlukan akaun dengan Advanced Access atau Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks dan address_clicks memerlukan Verified Business Account.

Mengapa sesuatu metrik boleh hilang atau lewat?

Ini berlaku kerana TikTok mengira kebanyakannya secara luar talian dan hanya daripada TikTok Analytics. Kiraan dan metrik tontonan biasanya lewat 24 hingga 48 jam, manakala item_id, caption dan links adalah masa nyata. Capaian, masa tontonan, sumber trafik dan audience_countries boleh hilang bagi video yang tidak ditonton, disukai, diulas atau dikongsi selama 7 hari; tip TikTok ialah berinteraksi dengannya dan cuba semula selepas 24 hingga 48 jam. Data berhenti dikemas kini 365 hari selepas diterbitkan, dan hantaran yang ditapis kerana pelanggaran, seperti hak cipta muzik, tidak dipulangkan.

Bagaimana easyCoexistence membaca metrik sesebuah video?

Dengan get_social_insights: beri item_id video sebagai object_id dan nama medan sebagai metrics, dan ia memulangkan medan hantaran itu, dengan mencarinya dalam 20 hantaran terbaharu akaun. Bagi hantaran lama, kod anda sendiri memanggil business/video/list/ dengan fields dan filters.video_ids sebagai parameter, menggunakan token daripada get_social_credentials.

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"]
}

Kesilapan biasa

  • Menganggap satu skala bagi setiap peratusan. Contoh TikTok memberikan impression_sources sebagai pecahan yang berjumlah 1, manakala contoh audience_cities menunjukkan nilai seperti 17.4921.
  • Meminta beberapa medan tanpa item_id. Rujukan TikTok memberi amaran bahawa permintaan sedemikian mungkin gagal.
  • Menjangka capaian bagi video lama yang senyap. TikTok boleh membiarkan capaian, masa tontonan dan sumber trafik kosong selepas 7 hari tanpa tontonan, suka, ulasan atau kongsi.
  • Membandingkan metrik hantaran dengan metrik akaun harian. Angka hantaran meliputi seluruh hayatnya, manakala metrik akaun datang mengikut hari bagi sehingga 60 hari.
Menggunakan EasyCoexistence untuk ini

Bagi hantaran lama, get_social_credentials memberi kod anda sendiri token akaun itu. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma pertama.

Soalan lazim

Adakah API TikTok memberi masa tontonan bagi setiap video?

Ya. total_time_watched dan average_time_watched datang dalam saat daripada /business/video/list/, bagi token dengan skop video.insights.

Bagaimana saya mendapatkan kadar tontonan penuh video TikTok melalui API?

Minta full_video_watched_rate dalam fields pada /business/video/list/. TikTok mentakrifkannya sebagai peratusan penonton yang menghabiskan tontonan video itu.

Mengapa capaian dan masa tontonan kosong bagi video TikTok saya?

TikTok boleh meninggalkannya bagi video yang tiada tontonan, suka, ulasan atau kongsi dalam 7 hari terakhir, dan data terkini lewat 24 hingga 48 jam.

Bolehkah API memulangkan metrik bagi satu video TikTok tertentu?

Boleh. Nyatakan IDnya dalam filters.video_ids, dengan item_id dan metrik yang anda mahu dalam fields.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada