Deine TikTok-Wiedergabeverlaufsdatei ist ein einfacher JSON-Textdatensatz aller Videos, die du abgespielt hast – gespeichert im Datenexport, den TikTok dir zum Herunterladen bereitstellt. Sobald du die Struktur kennst, kannst du sie lesen, Videos zählen und sogar Wiedergabesitzungen selbst schätzen.
Wenn du deine Daten bei TikTok anforderst und das JSON-Format wählst, wird der Export als ZIP-Archiv mit mehreren Dateien geliefert. Eine der interessantesten ist die Wiedergabeverlaufsdatei, die die Videos auflistet, die du im Laufe der Zeit angesehen hast. Diese Anleitung erklärt, wo die Datei liegt, wie ihr JSON aufgebaut ist und wie du sie sinnvoll interpretierst.
Was die Wiedergabeverlaufsdatei ist
Die Wiedergabeverlaufsdatei ist ein Protokoll der Videos, die in deinem "Für dich"- und "Abonniert"-Feed abgespielt wurden. Jeder Eintrag steht für ein einzelnes Video, das TikTok als angesehen erfasst hat, zusammen mit dem Zeitpunkt der Wiedergabe und einem Link zurück zum Originalvideo.
Es ist kein Analyse-Dashboard. Es sind Rohdaten: eine lange Liste von Zeitstempeln und URLs. Das macht sie für die persönliche Analyse sehr nützlich, aber auf den ersten Blick schwer lesbar – vor allem wenn dein Verlauf Monate oder Jahre umfasst.
Wo sie im Export zu finden ist
Nachdem du den TikTok-Export entpackt hast, sind die Wiedergabeverlaufsdaten in einem aktivitätsbezogenen Ordner gruppiert. In einem JSON-Export findest du sie in der Regel so verschachtelt:
- Activity → Video Browsing History (manchmal als Watch History bezeichnet),
- gespeichert in einer einzigen .json-Datei zusammen mit anderen Aktivitätsdateien wie Like List und Search History.
Die genauen Ordnernamen können je nach Exportversion leicht variieren. Wenn du dir nicht sicher bist, wie das Archiv aufgebaut ist, erklärt unser Leitfaden TikTok-Datenexportordner erklärt jeden Bereich. Den vollständigen Prozess zum Anfordern und Herunterladen findest du unter TikTok-Daten herunterladen und analysieren.
Die JSON-Struktur: VideoList-Einträge
Innerhalb der Datei sind die Wiedergabedatensätze unter einem Schlüssel namens VideoList gespeichert. Es handelt sich um ein Array von Objekten, wobei jedes Objekt ein angesehenes Video beschreibt. Ein einzelner Eintrag sieht ungefähr so aus:
- Date — wann das Video angesehen wurde, z. B. "2026-02-14 18:32:07",
- Link — die URL des Videos, z. B. "https://www.tiktokv.com/share/video/7300000000000000000/".
Die Gesamtstruktur ist also ein Objekt der obersten Ebene, das das Array enthält – man kann es sich vorstellen als { "Video Browsing History": { "VideoList": [ ... ] } }. Jedes Element von VideoList ist ein Abspiel-Ereignis mit einem Date- und einem Link-Feld. Es gibt keine Aufrufzahlen, keine Engagement-Zahlen und keine Beschriftungen – nur wann und was.
Videos manuell zählen
Die einfachste Kennzahl ist die Gesamtanzahl der angesehenen Videos, die der Länge des VideoList-Arrays entspricht. Du kannst sie auf verschiedene Arten ermitteln:
- Öffne die Datei in einem Code-Editor und schau dir die Array-Länge an, oder
- lade sie in einer Browser-Konsole mit data['Video Browsing History'].VideoList.length, oder
- verwende ein Befehlszeilenwerkzeug, um das Vorkommen des Date-Schlüssels zu zählen.
Eindeutige Videos zu zählen ist etwas schwieriger, weil derselbe Link mehr als einmal erscheinen kann, wenn du ein Video erneut angesehen hast. Um Eindeutige zu zählen, musst du nach dem Link-Feld deduplizieren, anstatt einfach nur Zeilen zu zählen.
Sitzungen schätzen oder ein Tool verwenden
Eine "Sitzung" ist eine ununterbrochene Wiedergabesequenz. Der Export kennzeichnet keine Sitzungen, daher musst du sie aus den Date-Zeitstempeln ableiten. Ein verbreiteter Ansatz ist, Einträge nach Datum zu sortieren und Videos, die zeitlich nah beieinanderliegen, zu gruppieren:
- Sortiere alle Einträge nach ihrem Date-Wert,
- gehe die Liste durch und beginne eine neue Sitzung, wenn der Abstand zwischen zwei aufeinanderfolgenden Videos einen Schwellenwert überschreitet (zum Beispiel 30 Minuten),
- zähle, wie viele Sitzungen sich ergeben.
Dies manuell über Tausende von Einträgen hinweg zu tun ist mühsam und fehleranfällig. Ein Tool wie TikTok Wrapped führt diese Gruppierung automatisch durch und verwandelt sie in lesbare Zusammenfassungen. Du kannst ein Beispiel-Wrapped ansehen, um zu sehen, wie das Ergebnis aussieht, oder deinen eigenen Export analysieren.
Häufige Stolpersteine
Datumsformate und Zeitzonen
Das Date-Feld ist eine Zeichenkette und kein echtes Datum, und es wird häufig in UTC statt in deiner lokalen Zeit erfasst. Wenn du es ohne Berücksichtigung der Zeitzone analysierst, können deine Sitzungsgrenzen und Ergebnisse zur "aktivsten Stunde" um mehrere Stunden verschoben sein.
Unvollständiger Verlauf
Der Export enthält möglicherweise nicht deinen gesamten Wiedergabeverlauf. TikTok begrenzt, wie weit manche Aktivitäten zurückreichen. Eine leere oder kurze VideoList bedeutet daher nicht immer, dass du wenig geschaut hast – es kann auch bedeuten, dass das Exportfenster begrenzt war.
Große Dateien
Vielnutzer können Wiedergabeverlaufsdateien haben, die Dutzende von Megabyte groß sind. Manche Texteditoren haben Schwierigkeiten, so große Dateien zu öffnen. Wenn sich eine Datei nicht öffnen lässt oder deinen Editor einfriert, deutet das darauf hin, dass die Daten umfangreich sind – nicht dass die Datei beschädigt ist.
Unterschiede bei Schlüsselnamen
Da TikTok gelegentlich Schlüssel zwischen Exportversionen umbenennt, kann der Wrapper-Schlüssel um VideoList abweichen. Wenn data['Video Browsing History'] undefined ist, überprüfe zuerst die Schlüssel der obersten Ebene, um die korrekte Bezeichnung zu finden.
Fazit
Die Wiedergabeverlaufs-JSON-Datei ist einer der aufschlussreichsten Teile deines TikTok-Exports. Sobald du verstehst, dass es sich nur um ein VideoList-Array aus Date- und Link-Paaren handelt, wird das Zählen von Videos und das Schätzen von Sitzungen geradlinig – auch wenn die Stolpersteine bei Zeitzonen, unvollständigem Verlauf und Dateigröße leicht zu übersehen sind.
Wenn du das manuelle Parsen lieber vermeiden möchtest, kann ein Analysetool dieselbe Datei lesen und dir die Ergebnisse in Sekunden präsentieren.