Il file della cronologia di visualizzazione TikTok è un record JSON in testo normale di ogni video che hai riprodotto, archiviato all'interno dell'esportazione dati che TikTok ti consente di scaricare. Una volta compresa la sua struttura, puoi leggerlo, contare i video e persino stimare le sessioni di visualizzazione autonomamente.
Quando richiedi i tuoi dati a TikTok e scegli il formato JSON, l'esportazione arriva come archivio ZIP contenente diversi file. Uno dei più interessanti è il file della cronologia di visualizzazione, che elenca i video che hai guardato nel tempo. Questa guida illustra dove si trova il file, come è organizzato il suo JSON e come interpretarne il contenuto.
Cos'è il File della Cronologia di Visualizzazione
Il file della cronologia di visualizzazione è un registro dei video riprodotti nei tuoi feed Per Te e Seguiti. Ogni voce rappresenta un singolo video che TikTok ha registrato come guardato, insieme all'ora in cui è stato riprodotto e un link al video originale.
Non è una dashboard di analisi. Sono dati grezzi: un lungo elenco di timestamp e URL. Questo lo rende potente per l'analisi personale, ma più difficile da leggere a colpo d'occhio, soprattutto se la tua cronologia copre mesi o anni.
Dove Si Trova nell'Esportazione
Dopo aver decompresso l'esportazione TikTok, i dati della cronologia di visualizzazione sono raggruppati in una cartella relativa all'attività. In un'esportazione JSON la troverai tipicamente annidata in questo modo:
- Activity → Video Browsing History (a volte denominata Watch History),
- archiviata in un singolo file .json insieme ad altri file di attività come Like List e Search History.
I nomi esatti delle cartelle possono variare leggermente tra le versioni di esportazione. Se non sei sicuro di come è strutturato l'archivio, la nostra guida su cartelle dell'esportazione dati TikTok spiegate descrive nel dettaglio ogni sezione. Per il processo completo di richiesta e download, consulta come scaricare e analizzare i dati TikTok.
La Struttura JSON: Le Voci di VideoList
All'interno del file, i record di visualizzazione sono archiviati sotto una chiave solitamente denominata VideoList. È un array di oggetti, dove ogni oggetto descrive un video guardato. Una singola voce appare all'incirca così:
- Date — quando il video è stato guardato, ad es. "2026-02-14 18:32:07",
- Link — l'URL del video, ad es. "https://www.tiktokv.com/share/video/7300000000000000000/".
La forma complessiva è quindi un oggetto di primo livello contenente l'array, che si può pensare come { "Video Browsing History": { "VideoList": [ ... ] } }. Ogni elemento di VideoList è un evento di riproduzione con un campo Date e un campo Link. Non ci sono conteggi di visualizzazioni, dati di coinvolgimento o didascalie — solo quando e cosa.
Come Contare i Video Manualmente
La metrica più semplice è il numero totale di video guardati, che corrisponde alla lunghezza dell'array VideoList. Puoi trovarlo in diversi modi:
- aprire il file in un editor di codice e guardare la lunghezza dell'array, oppure
- caricarlo nella console del browser con data['Video Browsing History'].VideoList.length, oppure
- usare uno strumento da riga di comando per contare le occorrenze della chiave Date.
Contare i video unici è un po' più difficile, perché lo stesso Link può apparire più di una volta se hai rivisto un video. Per contare i valori unici, dovresti deduplicare in base al campo Link anziché contare semplicemente le righe.
Stimare le Sessioni vs Usare uno Strumento
Una "sessione" è un periodo di visione continuativa. L'esportazione non etichetta le sessioni, quindi devi dedurle dai timestamp Date. Un approccio comune consiste nell'ordinare le voci per data e raggruppare i video vicini nel tempo:
- ordinare tutte le voci per il loro valore Date,
- scorrere l'elenco e iniziare una nuova sessione ogni volta che il gap tra due video consecutivi supera una soglia (ad esempio, 30 minuti),
- contare quante sessioni ne risultano.
Farlo manualmente su migliaia di voci è tedioso e soggetto a errori. Uno strumento come TikTok Wrapped esegue questo raggruppamento automaticamente e lo trasforma in riepiloghi leggibili. Puoi visualizzare un esempio wrapped per vedere come appare il risultato, oppure analizzare la tua esportazione direttamente.
Errori Comuni
Formati di Data e Fusi Orari
Il campo Date è una stringa, non un vero datetime, ed è spesso registrato in UTC anziché nell'ora locale. Se lo analizzi senza tenere conto del fuso orario, i confini delle sessioni e i risultati dell'"ora più attiva" possono spostarsi di diverse ore.
Cronologia Parziale
L'esportazione potrebbe non includere l'intera storia delle tue visualizzazioni. TikTok limita la profondità temporale di alcune attività, quindi un VideoList vuoto o breve non significa necessariamente che hai guardato poco — potrebbe significare che la finestra di esportazione era limitata.
File di Grandi Dimensioni
Gli utenti più attivi possono trovarsi con file della cronologia di visualizzazione di decine di megabyte. Alcuni editor di testo faticano ad aprire file così grandi. Se un file non si apre o blocca il tuo editor, è un segnale che i dati sono voluminosi, non corrotti.
Differenze nei Nomi delle Chiavi
Poiché TikTok rinomina occasionalmente le chiavi tra le versioni di esportazione, la chiave wrapper attorno a VideoList potrebbe differire. Se data['Video Browsing History'] è undefined, ispeziona prima le chiavi di primo livello per trovare l'etichetta corretta.
Considerazioni Finali
Il file JSON della cronologia di visualizzazione è una delle parti più rivelatrici dell'esportazione TikTok. Una volta compreso che si tratta semplicemente di un array VideoList di coppie Date e Link, contare i video e stimare le sessioni diventa semplice — anche se le insidie legate al fuso orario, alla cronologia parziale e alle dimensioni del file sono facili da incontrare.
Se preferisci evitare il parsing manuale, uno strumento di analisi può leggere lo stesso file e presentarti i risultati in pochi secondi.