AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Videometriken über die API: Aufrufe, Wiedergabezeit und Abschlussrate

Die API for Business von TikTok liefert die Metriken jedes Beitrags über seine gesamte Laufzeit von GET /business/video/list/. Sie werden mit Namen in fields angefordert: video_views, reach, likes, comments, shares und favorites, total_time_watched und average_time_watched in Sekunden, full_video_watched_rate, video_view_retention, impression_sources und Zuschauer-Aufschlüsselungen wie audience_countries. Die meisten Zählwerte treffen 24 bis 48 Stunden verspätet ein und werden 365 Tage nach der Veröffentlichung nicht mehr aktualisiert.

easyCoexistence liest die Metriken eines TikTok-Videos mit get_social_insights aus Claude, ChatGPT oder Ihrem eigenen Code.

video.insights

Benötigter Scope für Wiedergabezeit, Abschlussrate, Retention, Traffic-Quellen und Zuschauer-Aufschlüsselungen; die Grundzählwerte benötigen video.list.

7 days

Inaktivität, nach der Reichweite, Wiedergabezeit, Traffic-Quellen und audience_countries bei einem Video fehlen können.

10

Die meisten Einträge in den Listen audience_countries und audience_cities eines Videos.

24 to 48 h

Übliche Verzögerung für video_views, likes, reach, Wiedergabezeit und Traffic-Quellen, in UTC.

Welche Metriken hat ein Video?

GET /business/video/list/ liefert diese für jeden in fields genannten Beitrag, aggregiert über die gesamte Laufzeit des Beitrags und nicht über das 60-Tage-Fenster der Kontometriken. Zählwerte wie Aufrufe und Likes benötigen den video.list-Scope am Token, während die Werte zu Wiedergabe, Abschluss und Retention video.insights benötigen:

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

Wie fragen Sie sie ab?

Nennen Sie sie in fields, einem JSON-Array, das item_id enthalten muss, sobald mehr als ein Feld aufgelistet ist. Beiträge wählen Sie mit filters.video_ids aus. Ohne diesen Filter blättert der Endpoint durch die Beiträge des Kontos, jeweils bis zu 20:

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

Wie sieht die Antwort aus?

Ein videos-Array mit einem Objekt pro Beitrag und den angeforderten Feldern, dazu cursor und has_more für die Paginierung. Das gekürzte Beispiel von TikTok zeigt die Einheiten: Wiedergabezeiten in Sekunden mit bis zu drei Nachkommastellen und full_video_watched_rate als Dezimalzahl, hier 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
  }
}

Was bedeuten die Traffic-Quellen?

impression_sources ordnet, wo Zuschauer den Beitrag entdeckt haben, vom größten bis zum kleinsten Anteil. Jeder Eintrag ist eine impression_source mit ihrem Prozentwert. TikTok dokumentiert diese Werte:

  • For You: der For-You-Feed.
  • Follow: der Follow-Feed.
  • Sound: Sound-Seiten.
  • Personal Profile: Profilseiten.
  • Search: Suchseiten.
  • Direct Message: Direktnachrichten, wenn TikTok Studio diese Daten für das Konto anzeigt.
  • Others: alles Übrige.

Welche Zuschauer-Aufschlüsselungen gibt es?

Vier. Alle beschreiben die Personen, die diesen Beitrag gesehen haben, nicht die Follower des Kontos, und alle benötigen video.insights:

  • audience_genders: Anteile der Zuschauer nach Geschlecht, Female, Male oder Other.
  • audience_countries: bis zu 10 Länder oder Regionen als ISO-3166-1-Alpha-2-Codes.
  • audience_cities: bis zu 10 Städte, benannt wie US Cincinnati.
  • audience_types: NEW_VIEWER und RETURN_VIEWER sowie FOLLOWER_PERCENT gegenüber NON_FOLLOWER_PERCENT.

Welche Metriken hängen vom Kontotyp ab?

Einige Klicks und Profilbesuche stammen aus TikToks Business Analytics und setzen mehr als ein persönliches Konto voraus. profile_views, die Profilbesuche, die ein Beitrag ausgelöst hat, benötigt ein Konto mit Advanced Access oder ein verifiziertes Business-Konto. website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks und address_clicks benötigen ein verifiziertes Business-Konto.

Warum kann eine Metrik fehlen oder verspätet sein?

Weil TikTok die meisten davon offline und nur aus TikTok Analytics berechnet. Zählwerte und Wiedergabemetriken hinken üblicherweise 24 bis 48 Stunden hinterher, während item_id, caption und links in Echtzeit vorliegen. Reichweite, Wiedergabezeit, Traffic-Quellen und audience_countries können bei einem Video fehlen, das 7 Tage lang niemand angesehen, geliked, kommentiert oder geteilt hat. TikToks Tipp lautet, damit zu interagieren und nach 24 bis 48 Stunden erneut abzufragen. Die Daten werden 365 Tage nach der Veröffentlichung nicht mehr aktualisiert, und Beiträge, die wegen Verstößen gefiltert wurden, etwa wegen Musikurheberrecht, werden nicht zurückgegeben.

Wie liest easyCoexistence die Metriken eines Videos?

Mit get_social_insights: Übergeben Sie die item_id des Videos als object_id und die Feldnamen als metrics. Dann liefert es die Felder dieses Beitrags, gesucht unter den 20 neuesten Beiträgen des Kontos. Für einen älteren Beitrag ruft Ihr eigener Code business/video/list/ mit fields und filters.video_ids als Parameter auf, mit dem Token aus 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"]
}

Häufige Fehler

  • Eine einheitliche Skala für alle Prozentwerte annehmen. TikToks Beispiele geben impression_sources als Brüche an, die sich zu 1 addieren, während das audience_cities-Beispiel Werte wie 17.4921 zeigt.
  • Mehrere Felder ohne item_id anfordern. Die Referenz von TikTok warnt, dass eine solche Anfrage fehlschlagen kann.
  • Reichweite bei einem alten, ruhigen Video erwarten. TikTok kann Reichweite, Wiedergabezeit und Traffic-Quellen nach 7 Tagen ohne Aufrufe, Likes, Kommentare oder Shares leer lassen.
  • Beitragsmetriken mit täglichen Kontometriken vergleichen. Die Werte eines Beitrags decken seine gesamte Laufzeit ab, während Kontometriken tageweise für bis zu 60 Tage vorliegen.
Mit EasyCoexistence

Nennen Sie die gewünschten Felder, etwa video_views, reach oder full_video_watched_rate, und geben Sie die item_id des Videos an. Für ältere Beiträge gibt get_social_credentials Ihrem eigenen Code das Token des Kontos. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.

Häufig gestellte Fragen

Gibt die TikTok-API die Wiedergabezeit pro Video aus?

Ja. total_time_watched und average_time_watched kommen in Sekunden von /business/video/list/, für Token mit dem Scope video.insights.

Wie erhalte ich die Abschlussrate eines TikTok-Videos über die API?

Fordern Sie full_video_watched_rate in fields bei /business/video/list/ an. TikTok definiert sie als den Anteil der Zuschauer, die das Video bis zum Ende ansehen.

Warum sind Reichweite und Wiedergabezeit bei meinem TikTok-Video leer?

TikTok kann sie bei einem Video ohne Aufrufe, Likes, Kommentare oder Shares in den letzten 7 Tagen weglassen, und aktuelle Daten hinken 24 bis 48 Stunden hinterher.

Kann die API Metriken für ein bestimmtes TikTok-Video zurückgeben?

Ja. Übergeben Sie seine ID in filters.video_ids, mit item_id und den gewünschten Metriken in fields.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am