Файл Watch History у TikTok — це звичайний текстовий JSON-запис кожного переглянутого вами відео, збережений усередині архіву даних, який TikTok дозволяє завантажити. Розібравшись у його структурі, ви зможете самостійно читати файл, рахувати відео й навіть оцінювати тривалість сесій перегляду.
Коли ви запитуєте свої дані у TikTok і обираєте формат JSON, експорт надходить у вигляді ZIP-архіву з кількома файлами. Один із найцікавіших — файл Watch History, який містить список відео, переглянутих вами з часом. У цьому посібнику розглядається, де знаходиться файл, як організований його JSON і як у ньому розібратися.
Що таке файл Watch History
Файл Watch History — це журнал відео, що відтворювалися у ваших стрічках «Для тебе» та «Підписки». Кожен запис відповідає одному відео, яке TikTok зафіксував як переглянуте, разом із часом відтворення та посиланням на оригінальне відео.
Це не аналітична панель. Це сирі дані: довгий список міток часу та URL-адрес. Завдяки цьому вони потужні для особистого аналізу, але важкі для швидкого читання — особливо якщо ваша історія охоплює місяці або роки.
Де він знаходиться в архіві
Після розпакування архіву TikTok дані Watch History згруповані в папці, пов'язаній з активністю. У JSON-експорті вони зазвичай розташовані так:
- Activity → Video Browsing History (іноді позначена як Watch History),
- збережена в одному .json-файлі разом з іншими файлами активності, як-от Like List і Search History.
Точні назви папок можуть дещо відрізнятися між версіями експорту. Якщо ви не впевнені, як влаштований архів, наш посібник про папки експорту даних TikTok детально пояснює кожен розділ. Щодо повного процесу запиту та завантаження — дивіться як завантажити й проаналізувати дані TikTok.
Структура JSON: записи VideoList
Усередині файлу записи переглядів зберігаються під ключем, який зазвичай називається VideoList. Це масив об'єктів, де кожен об'єкт описує одне переглянуте відео. Окремий запис виглядає приблизно так:
- Date — коли було переглянуто відео, наприклад "2026-02-14 18:32:07",
- Link — URL відео, наприклад "https://www.tiktokv.com/share/video/7300000000000000000/".
Загальна структура — це об'єкт верхнього рівня, що містить масив: { "Video Browsing History": { "VideoList": [ ... ] } }. Кожен елемент VideoList — це одна подія відтворення з полями Date і Link. Тут немає лічильників переглядів, показників залученості чи підписів — лише коли і що.
Як порахувати відео вручну
Найпростіший показник — загальна кількість переглянутих відео, що дорівнює довжині масиву VideoList. Це можна з'ясувати кількома способами:
- відкрити файл у редакторі коду й подивитися на довжину масиву,
- завантажити його в консолі браузера через data['Video Browsing History'].VideoList.length,
- скористатися інструментом командного рядка для підрахунку входжень ключа Date.
Підрахувати унікальні відео трохи складніше, адже один і той самий Link може зустрічатися кілька разів, якщо ви переглядали відео повторно. Щоб отримати кількість унікальних, потрібно видалити дублікати за полем Link, а не просто рахувати рядки.
Оцінка сесій або використання інструменту
"Сесія" — це безперервний відрізок перегляду. Експорт не позначає сесії, тому їх доводиться визначати за мітками часу Date. Поширений підхід — відсортувати записи за датою та згрупувати відео, що йдуть близько одне за одним:
- відсортувати всі записи за значенням Date,
- пройтися по списку й починати нову сесію щоразу, коли проміжок між двома послідовними відео перевищує порогове значення (наприклад, 30 хвилин),
- порахувати, скільки сесій вийшло.
Робити це вручну для тисяч записів — стомлююче й ненадійне. Інструмент на кшталт TikTok Wrapped виконує таке групування автоматично й перетворює результати на зрозумілі підсумки. Ви можете переглянути приклад Wrapped, щоб побачити, як виглядає результат, або проаналізувати власний архів безпосередньо.
Типові підводні камені
Формати дат і часові пояси
Поле Date — це рядок, а не справжній об'єкт дати/часу, і воно часто записується в UTC, а не за вашим місцевим часом. Якщо парсити його без урахування часового поясу, межі сесій і результати «найактивнішої години» можуть зміститися на кілька годин.
Неповна історія
Експорт може не містити всієї вашої історії переглядів за весь час. TikTok обмежує глибину деяких даних активності, тому порожній або короткий VideoList не завжди означає, що ви мало дивилися — можливо, просто вікно експорту виявилося обмеженим.
Великі файли
У активних користувачів файли Watch History можуть важити десятки мегабайт. Деякі текстові редактори важко справляються з такими великими файлами. Якщо файл не відкривається або заморожує редактор — це ознака великого обсягу даних, а не їх пошкодження.
Відмінності в назвах ключів
Оскільки TikTok інколи перейменовує ключі між версіями експорту, ключ-обгортка навколо VideoList може відрізнятися. Якщо data['Video Browsing History'] повертає undefined, спочатку перегляньте ключі верхнього рівня, щоб знайти правильну назву.
Висновок
JSON-файл Watch History — один із найінформативніших розділів вашого архіву TikTok. Коли ви розумієте, що це просто масив VideoList із парами Date і Link, підрахунок відео й оцінка сесій стають простими — хоча підводні камені з часовим поясом, неповною історією та розміром файлу легко можуть завести в оману.
Якщо ви не хочете займатися ручним парсингом, інструмент аналізу зчитає той самий файл і представить результати за лічені секунди.