Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Metrike TikTok videa putem API-ja: pregledi, vrijeme gledanja i dovršenost

TikTokov API za poslovanje vraća metrike za cijeli život svake objave iz GET /business/video/list/, zatražene po nazivu u fields: video_views, reach, likes, comments, shares i favorites, total_time_watched i average_time_watched u sekundama, full_video_watched_rate, video_view_retention, impression_sources te raščlambe gledatelja poput audience_countries. Većina brojki stiže s kašnjenjem od 24 do 48 sati i prestaje se ažurirati 365 dana nakon objave.

easyCoexistence čita metrike TikTok videa pomoću get_social_insights, dostupnog u Claude, ChatGPT ili vlastitom kodu: navedite polja, poput video_views, reach ili full_video_watched_rate, i dajte item_id videa.

video.insights

Opseg potreban za vrijeme gledanja, dovršenost, zadržavanje, izvore prometa i raščlambe gledatelja; osnovne brojke traže video.list.

7 days

Neaktivnost nakon koje reach, vrijeme gledanja, izvori prometa i audience_countries mogu nedostajati za video.

10

Većina unosa u popisima audience_countries i audience_cities za video.

24 to 48 h

Uobičajeno kašnjenje za video_views, likes, reach, vrijeme gledanja i izvore prometa, u UTC-u.

Koje metrike ima video?

GET /business/video/list/ vraća ove podatke za svaku objavu navedenu u fields, zbrojene za cijeli život objave, a ne za 60-dnevni prozor metrika računa. Brojke poput pregleda i sviđanja traže opseg video.list na tokenu, dok su podaci o gledanju, dovršenosti i zadržavanju potrebni opseg 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

Kako ih zatražiti?

Navedite ih u fields, JSON nizu koji mora sadržavati item_id kad god navodi više od jednog polja, a objave birajte pomoću filters.video_ids. Bez filtera endpoint prolazi kroz objave računa, do 20 odjednom:

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

Kako izgleda odgovor?

Niz videos s jednim objektom po objavi i traženim poljima, uz cursor i has_more za straničenje. TikTokov vlastiti skraćeni primjer pokazuje mjerne jedinice: vremena gledanja u sekundama s najviše tri decimale, a full_video_watched_rate kao decimalni broj, ovdje 0.0237:

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

Što znače izvori prometa?

impression_sources rangira mjesta na kojima su gledatelji otkrili objavu, od najvećeg udjela do najmanjeg, a svaki unos je impression_source s postotkom. TikTok dokumentira ove vrijednosti:

  • For You: feed For You.
  • Follow: feed Follow.
  • Sound: stranice zvukova.
  • Personal Profile: stranice profila.
  • Search: stranice pretrage.
  • Direct Message: izravne poruke, kad TikTok Studio prikazuje te podatke za račun.
  • Others: sve ostalo.

Koje raščlambe gledatelja postoje?

Četiri, sve opisuju ljude koji su gledali tu objavu, a ne pratitelje računa, i sve traže video.insights:

  • audience_genders: udjeli gledatelja po spolu, Female, Male ili Other.
  • audience_countries: do 10 zemalja ili regija, kao kodovi ISO 3166-1 alpha-2.
  • audience_cities: do 10 gradova, zapisanih poput US Cincinnati.
  • audience_types: NEW_VIEWER i RETURN_VIEWER te FOLLOWER_PERCENT naspram NON_FOLLOWER_PERCENT.

Koje metrike ovise o vrsti računa?

Nekoliko klikova i posjeta profilu dolazi iz TikTok Business Analytics i zahtijeva više od osobnog računa. profile_views, posjete profilu koje je objava potaknula, traži račun s Advanced Access ili Verified Business Account. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks i address_clicks traže Verified Business Account.

Zašto metrika može nedostajati ili kasniti?

Jer TikTok većinu njih računa izvan mreže, i to samo iz podataka TikTok Analytics. Podaci o gledanju i brojke obično kasne 24 do 48 sati, dok su item_id, caption i links u stvarnom vremenu. Reach, vrijeme gledanja, izvori prometa i audience_countries mogu nedostajati za video koji u 7 dana nitko nije gledao, označio sviđanjem, komentirao ili podijelio; TikTokov savjet je da s njim komunicirate i pokušate ponovno nakon 24 do 48 sati. Podaci prestaju se ažurirati 365 dana nakon objave, a objave filtrirane zbog kršenja, poput autorskih prava na glazbu, ne vraćaju se.

Kako easyCoexistence čita metrike videa?

Pomoću get_social_insights: item_id videa dajte kao object_id, a nazive polja kao metrics, i alat vraća polja te objave tražeći među 20 najnovijih objava računa. Za stariju objavu vlastiti kod poziva business/video/list/ s parametrima fields i filters.video_ids, koristeći token iz 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"]
}

Uobičajene pogreške

  • Pretpostavka jednog mjerila za sve postotke. TikTokovi primjeri daju impression_sources kao udjele čiji zbroj iznosi 1, dok njegov primjer audience_cities pokazuje vrijednosti poput 17.4921.
  • Traženje više polja bez item_id. TikTokova referenca upozorava da takav zahtjev može ne uspjeti.
  • Očekivanje dosega za stari, neaktivan video. TikTok može ostaviti reach, vrijeme gledanja i izvore prometa praznima nakon 7 dana bez pregleda, sviđanja, komentara ili dijeljenja.
  • Usporedba metrika objave s dnevnim metrikama računa. Brojke objave pokrivaju cijeli njezin život, dok metrike računa dolaze po danima za do 60 dana.
Radite ovo uz EasyCoexistence

Za starije objave, get_social_credentials daje vašem kodu token računa. US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s prvih 3 dana besplatno.

Često postavljana pitanja

Daje li TikTok API vrijeme gledanja po videu?

Da. total_time_watched i average_time_watched dolaze u sekundama iz /business/video/list/, za tokene s opsegom video.insights.

Kako preko API-ja dobiti stopu dovršenosti TikTok videa?

Zatražite full_video_watched_rate u fields na /business/video/list/. TikTok je definira kao postotak gledatelja koji dogledaju video do kraja.

Zašto su reach i vrijeme gledanja prazni za moj TikTok video?

TikTok ih može izostaviti za video bez pregleda, sviđanja, komentara ili dijeljenja u posljednjih 7 dana, a noviji podaci kasne 24 do 48 sati.

Može li API vratiti metrike za jedan određeni TikTok video?

Da. Navedite njegov ID u filters.video_ids, a item_id i metrike koje želite u fields.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na