Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Mga metrics ng TikTok video sa pamamagitan ng API: views, watch time at completion

Ibinabalik ng API for Business ng TikTok ang lifetime metrics ng bawat post mula sa GET /business/video/list/, na hinihingi sa pamamagitan ng pangalan sa fields: video_views, reach, likes, comments, shares at favorites, total_time_watched at average_time_watched sa segundo, full_video_watched_rate, video_view_retention, impression_sources, at mga viewer breakdown tulad ng audience_countries. Karamihan sa mga bilang ay dumarating nang 24 hanggang 48 oras na huli at humihinto sa pag-update 365 araw matapos i-publish.

Binabasa ng easyCoexistence ang metrics ng TikTok video gamit ang get_social_insights mula sa Claude, ChatGPT o sa sarili ninyong code: pangalanan ang mga field na gusto ninyo, tulad ng video_views, reach o full_video_watched_rate, at ibigay ang item_id ng video.

video.insights

Scope na kailangan para sa watch time, completion, retention, traffic sources at viewer breakdowns; ang basic na bilang ay nangangailangan ng video.list.

7 days

Ang kawalan ng aktibidad ay maaaring magdulot ng pagkawala ng reach, watch time, traffic sources at audience_countries ng isang video.

10

Karamihan sa mga entry sa listahan ng audience_countries at audience_cities ng isang video.

24 to 48 h

Karaniwang delay para sa video_views, likes, reach, watch time at traffic sources, sa UTC.

Anong metrics mayroon ang isang video?

Ibinabalik ng GET /business/video/list/ ang mga ito para sa bawat post na nakapangalan sa fields, pinagsama-sama sa buong buhay ng post at hindi sa 60-araw na window ng account metrics. Ang mga bilang tulad ng views at likes ay nangangailangan ng video.list scope sa token, habang ang watch, completion at retention figures ay nangangailangan ng 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

Paano ito hihingin?

Pangalanan ang mga ito sa fields, isang JSON array na dapat may kasamang item_id kapag higit sa isang field ang nakalista, at piliin ang mga post gamit ang filters.video_ids. Kung walang filter, dadaan ang endpoint sa mga post ng account, hanggang 20 sa isang pagkakataon:

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

Ano ang itsura ng response?

Isang videos array na may isang object para sa bawat post at ang mga hiniling na fields, kasama ang cursor at has_more para sa paging. Ipinapakita ng halimbawa ng TikTok mismo, pinaikli, ang mga unit: watch times sa segundo na may hanggang tatlong decimal, at ang full_video_watched_rate bilang decimal, 0.0237 dito:

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

Ano ang ibig sabihin ng traffic sources?

Inirarank ng impression_sources kung saan natuklasan ng mga viewer ang post, mula sa pinakamalaking bahagi hanggang sa pinakamaliit. Bawat entry ay isang impression_source na may kanyang porsyento. Dokumentado ng TikTok ang mga value na ito:

  • For You: ang For You feed.
  • Follow: ang Follow feed.
  • Sound: mga sound page.
  • Personal Profile: mga profile page.
  • Search: mga search page.
  • Direct Message: direct messages, kapag ipinapakita ng TikTok Studio ang datos na iyon para sa account.
  • Others: lahat ng iba pa.

Anong viewer breakdowns ang mayroon?

Apat, lahat ay naglalarawan sa mga taong nanood ng post na iyon at hindi sa followers ng account, at lahat ay nangangailangan ng video.insights:

  • audience_genders: bahagi ng mga viewer ayon sa kasarian, Female, Male o Other.
  • audience_countries: hanggang 10 bansa o rehiyon, gamit ang ISO 3166-1 alpha-2 codes.
  • audience_cities: hanggang 10 lungsod, nakapangalan tulad ng US Cincinnati.
  • audience_types: NEW_VIEWER at RETURN_VIEWER, at FOLLOWER_PERCENT laban sa NON_FOLLOWER_PERCENT.

Aling metrics ang nakadepende sa uri ng account?

Ang ilang clicks at profile visits ay galing sa Business Analytics ng TikTok at nangangailangan ng higit pa sa personal na account. Ang profile_views, ang mga profile visit na naidulot ng post, ay nangangailangan ng account na may Advanced Access o isang Verified Business Account. Ang website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks at address_clicks ay nangangailangan ng Verified Business Account.

Bakit maaaring mawala o mahuli ang isang metric?

Dahil kinukwenta ng TikTok ang karamihan sa mga ito offline at mula lamang sa TikTok Analytics. Karaniwang nahuhuli ang mga bilang at watch metrics ng 24 hanggang 48 oras, habang real time ang item_id, caption at links. Maaaring mawala ang reach, watch time, traffic sources at audience_countries para sa video na walang nanood, nag-like, nag-comment o nag-share sa loob ng 7 araw. Payo ng TikTok na makipag-interact dito at subukan muli pagkatapos ng 24 hanggang 48 oras. Huminto sa pag-update ang data 365 araw matapos i-publish, at ang mga post na na-filter dahil sa paglabag, tulad ng copyright ng musika, ay hindi ibinabalik.

Paano binabasa ng easyCoexistence ang metrics ng isang video?

Gamit ang get_social_insights: ibigay ang item_id ng video bilang object_id at ang mga pangalan ng field bilang metrics. Ibabalik nito ang fields ng post na iyon, hinahanap sa 20 pinakabagong post ng account. Para sa mas lumang post, tinatawag ng sarili ninyong code ang business/video/list/ na may fields at filters.video_ids bilang parameters, gamit ang token mula sa 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"]
}

Mga karaniwang pagkakamali

  • Pag-aakalang iisang scale para sa lahat ng porsyento. Ipinapakita ng halimbawa ng TikTok na ang impression_sources ay fractions na nagdadagdag sa 1, habang ang halimbawa nito sa audience_cities ay nagpapakita ng mga value tulad ng 17.4921.
  • Paghiling ng ilang fields nang walang item_id. Nagbabala ang reference ng TikTok na maaaring pumalya ang ganitong request.
  • Pag-asa sa reach para sa luma at tahimik na video. Maaaring iwanang walang laman ng TikTok ang reach, watch time at traffic sources pagkatapos ng 7 araw na walang views, likes, comments o shares.
  • Pagkukumpara ng post metrics sa daily account metrics. Sakop ng figures ng post ang buong buhay nito, habang ang account metrics ay dumarating kada araw hanggang 60 araw.
Ginagawa ito gamit ang EasyCoexistence

Para sa mas lumang post, ibinibigay ng get_social_credentials sa sarili ninyong code ang token ng account. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Nagbibigay ba ang TikTok API ng watch time kada video?

Oo. Ang total_time_watched at average_time_watched ay dumarating sa segundo mula sa /business/video/list/, para sa token na may video.insights scope.

Paano ko makukuha ang completion rate ng isang TikTok video sa pamamagitan ng API?

Hilingin ang full_video_watched_rate sa fields sa /business/video/list/. Dinidefine ito ng TikTok bilang porsyento ng mga viewer na tinapos panoorin ang video.

Bakit walang laman ang reach at watch time ng video ko sa TikTok?

Maaaring alisin ito ng TikTok para sa video na walang views, likes, comments o shares sa huling 7 araw, at nahuhuli ng 24 hanggang 48 oras ang kamakailang data.

Maaari bang magbalik ang API ng metrics para sa iisang TikTok video?

Oo. Ipasa ang ID nito sa filters.video_ids, kasama ang item_id at ang mga metrics na gusto ninyo sa fields.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong