Votre fichier Watch History TikTok est un enregistrement JSON en texte brut de chaque vidéo que vous avez regardée, stocké dans l'export de données que TikTok vous permet de télécharger. Une fois que vous en connaissez la structure, vous pouvez le lire, compter les vidéos, et même estimer les sessions de visionnage vous-même.
Lorsque vous demandez vos données à TikTok et choisissez le format JSON, l'export arrive sous la forme d'une archive ZIP contenant plusieurs fichiers. L'un des plus intéressants est le fichier Watch History, qui répertorie les vidéos que vous avez regardées au fil du temps. Ce guide explique où se trouve le fichier, comment son JSON est organisé, et comment l'interpréter.
Qu'est-ce que le fichier Watch History
Le fichier Watch History est un journal des vidéos qui ont été lues dans vos fils Pour vous et Abonnements. Chaque entrée représente une vidéo unique que TikTok a enregistrée comme visionnée, accompagnée de l'heure à laquelle elle a été lue et d'un lien vers la vidéo d'origine.
Ce n'est pas un tableau de bord analytique. Ce sont des données brutes : une longue liste d'horodatages et d'URL. Cela le rend puissant pour une analyse personnelle, mais plus difficile à lire en un coup d'œil, surtout si votre historique couvre des mois ou des années.
Où il se trouve dans l'export
Après avoir décompressé l'export TikTok, les données Watch History sont regroupées dans un dossier lié à l'activité. Dans un export JSON, vous le trouverez généralement imbriqué ainsi :
- Activity → Video Browsing History (parfois intitulé Watch History),
- stocké dans un seul fichier .json aux côtés d'autres fichiers d'activité tels que Like List et Search History.
Les noms de dossiers exacts peuvent varier légèrement selon les versions d'export. Si vous n'êtes pas sûr de la structure de l'archive, notre guide sur les dossiers de l'export de données TikTok expliqués décrit chaque section. Pour le processus complet de demande et de téléchargement, consultez comment télécharger et analyser vos données TikTok.
La structure JSON : les entrées VideoList
Dans le fichier, les enregistrements de visionnage sont stockés sous une clé généralement nommée VideoList. Il s'agit d'un tableau d'objets, où chaque objet décrit une vidéo visionnée. Une entrée unique ressemble à peu près à ceci :
- Date — quand la vidéo a été regardée, par ex. "2026-02-14 18:32:07",
- Link — l'URL de la vidéo, par ex. "https://www.tiktokv.com/share/video/7300000000000000000/".
La forme globale est donc un objet de niveau supérieur contenant le tableau, que vous pouvez concevoir comme { "Video Browsing History": { "VideoList": [ ... ] } }. Chaque élément de VideoList est un événement de lecture avec un champ Date et un champ Link. Il n'y a pas de compteurs de vues, pas de chiffres d'engagement, pas de légendes — uniquement quand et quoi.
Comment compter les vidéos manuellement
La métrique la plus simple est le nombre total de vidéos visionnées, qui correspond à la longueur du tableau VideoList. Vous pouvez le trouver de plusieurs façons :
- ouvrir le fichier dans un éditeur de code et regarder la longueur du tableau, ou
- le charger dans la console d'un navigateur avec data['Video Browsing History'].VideoList.length, ou
- utiliser un outil en ligne de commande pour compter les occurrences de la clé Date.
Compter les vidéos uniques est un peu plus difficile, car le même Link peut apparaître plusieurs fois si vous avez revu une vidéo. Pour compter les doublons, vous devrez dédupliquer par le champ Link plutôt que de simplement compter les lignes.
Estimer les sessions ou utiliser un outil
Une « session » est une période de visionnage continu. L'export ne labélise pas les sessions, vous devez donc les déduire des horodatages Date. Une approche courante consiste à trier les entrées par date et à regrouper les vidéos proches dans le temps :
- trier toutes les entrées par leur valeur Date,
- parcourir la liste et démarrer une nouvelle session dès que l'écart entre deux vidéos consécutives dépasse un seuil (par exemple, 30 minutes),
- compter le nombre de sessions obtenues.
Faire cela à la main sur des milliers d'entrées est fastidieux et sujet aux erreurs. Un outil comme TikTok Wrapped effectue ce regroupement automatiquement et le transforme en résumés lisibles. Vous pouvez voir un exemple de wrapped pour voir à quoi ressemble le résultat, ou analyser votre propre export directement.
Pièges courants
Formats de date et fuseaux horaires
Le champ Date est une chaîne de caractères, pas un vrai datetime, et il est souvent enregistré en UTC plutôt qu'en heure locale. Si vous le parsez sans tenir compte du fuseau horaire, vos limites de session et vos résultats d'« heure la plus active » peuvent décaler de plusieurs heures.
Historique partiel
L'export peut ne pas inclure toute votre durée de visionnage. TikTok limite la profondeur de certaines activités, donc un VideoList vide ou court ne signifie pas toujours que vous avez peu regardé — cela peut signifier que la fenêtre d'export était limitée.
Fichiers volumineux
Les utilisateurs intensifs peuvent se retrouver avec des fichiers Watch History de plusieurs dizaines de mégaoctets. Certains éditeurs de texte peinent à ouvrir des fichiers aussi volumineux. Si un fichier refuse de s'ouvrir ou bloque votre éditeur, c'est signe que les données sont importantes et non que le fichier est corrompu.
Différences de nommage des clés
Comme TikTok renomme parfois les clés entre les versions d'export, la clé wrapper autour de VideoList peut différer. Si data['Video Browsing History'] est undefined, inspectez d'abord les clés de niveau supérieur pour trouver le bon libellé.
Réflexions finales
Le fichier JSON Watch History est l'une des parties les plus révélatrices de votre export TikTok. Une fois que vous comprenez qu'il s'agit simplement d'un tableau VideoList de paires Date et Link, compter les vidéos et estimer les sessions devient simple — même si les pièges liés aux fuseaux horaires, à l'historique partiel et à la taille des fichiers sont faciles à ne pas voir.
Si vous préférez éviter le parsing manuel, un outil d'analyse peut lire le même fichier et vous présenter les résultats en quelques secondes.