# Як перетворити коментарі TikTok на чергу продуктових багів

https://jsonscraper.com/uk/blog/tiktok-comments-product-bug-queue

Author: Michael Johnson

Published: 2026-11-18T11:42:21+00:00

Updated: 2026-11-18T11:42:21+00:00

Зберіть публічні коментарі до знайдених відео та збережіть вихідний JSON, щоб перевірити фактичну структуру відповіді до тематичного маркування.

Щоб дослідити обговорення проблеми в TikTok, спочатку знайдіть відповідні відео, а потім запросіть коментарі до кожного вибраного ролика. Для продуктової команди результатом може стати набір вихідних відповідей JSON, пов’язаних із запитом і посиланням на відео. Перш ніж створювати чергу тем, перевірте фактичну структуру коментарів: документація підтверджує маршрут і його параметри, але не описує поля записів у відповіді.

 

Це важливий етап аналітичного пайплайна. Результати пошуку допомагають зібрати контекст навколо продукту, а коментарі можуть містити повідомлення про помилки, запитання або обхідні сценарії. Щоб класифікація спиралася на реальні дані, спочатку збережіть відповідь API без перетворень, а потім зіставте поля з фактично отриманою схемою.

 

## Чому пошуку відео недостатньо

 

Назва застосунку або пристрою допомагає знайти відео, але опис ролика передусім показує формулювання автора. Глядачі можуть обговорювати конкретні несправності та способи використання в коментарях. Тож збирання коментарів додає до вибірки з пошуку другий рівень даних, пов’язаний із початковим відео.

 

У попередніх матеріалах розглядалися моніторинг пошуку TikTok, вилучення запитань з описів і обробка відповідей пошуку. Тут завдання вужче: зібрати відповіді маршруту коментарів і перевірити їхню структуру, перш ніж розробляти класифікацію. Це корисно розробникам аналітичних інтеграцій, дослідникам користувацького досвіду та командам підтримки.

 

## Від пошукової фрази до набору даних, який можна перевірити

 

Задайте кілька конкретних запитів, наприклад назву продукту разом із назвою функції або моделі. Збережіть відповідь пошуку та URL-адреси вибраних відео. Потім запросіть коментарі за URL-адресою, зберігаючи кожну вихідну відповідь окремо. Після перевірки схеми можна нормалізувати потрібні поля, видалити дублікати й згрупувати тексти за темами.



![Стаття: Як перетворити коментарі TikTok на чергу продуктових багів
Короткий опис: Пайплайн на Python поєднує пошук відео TikTok із запитом коментарів через jsonscraper. Приклад зберігає та виводить необроблений JSON, не припускаючи заздалегідь назв полів коментарів.
Роль зображення: додаткова ілюстрація 2 — інший конкретний аспект
Розділ: Від пошукової фрази до набору даних, який можна перевірити
Візуальна тема: Інфографіка російською мовою з процесом пошуку за ключовими словами → вибору відео → запиту коментарів](https://jsonscraper.com/assets/uploads/journal/2026/11/0fd7e8fd8c3e0ddec431e375056cca1b.png.hero.webp)

Схема відокремлює задокументовані кроки збирання від нормалізації після перевірки фактичної відповіді.© jsonscraper · ілюстрація, створена ШІ

 

1. **Пошук:** запросити відео за ключовою фразою та перевірити обидві підтримувані структури результату.
2. **Відбір:** вибрати доречні ролики й зберегти їхні ідентифікатори та URL-адреси.
3. **Збирання коментарів:** передати URL-адресу маршруту коментарів; для продовження пагінації використати повернутий курсор.
4. **Перевірка:** зберегти необроблений JSON і визначити фактичні назви полів за відповіддю.
5. **Аналіз:** після перевірки схеми згрупувати тексти й передати приклади людині на перевірку.

 

Схема: пошук відео TikTok, відбір роликів, запит коментарів, збереження вихідного JSON, перевірка структури та ручне тематичне маркування

Спочатку зберігайте відповідь цілком; додавайте нормалізацію після перевірки фактичних полів.

 

## Які маршрути використовувати

 

[Документація TikTok Scraper API](https://github.com/jsonscraper/tiktok-api-python/blob/main/docs/endpoints.md) описує `GET /searchVideo` з обов’язковим параметром `keyword`. Додаткові параметри включають `count`, `cursor`, `date_posted`, `sort_by` і `region`. Для коментарів передбачено `GET /getCommentsByUrl` з обов’язковим `video_url`; серед додаткових параметрів зазначені `cursor`, `count` і `region`. Ключ передається в параметрі `license_key`.

 

У відповіді пошуку відео можуть міститися в `tiktok.aweme_list` або в `tiktok.search_item_list[].aweme_info`. Приклад обробляє обидві форми, перевіряє зовнішній статус і зберігає знайдені об’єкти. Для відповіді з коментарями він не припускає ані назви масиву, ані назв полів: зберігає та виводить отриманий JSON, щоб його можна було перевірити.

 

## Мінімальний збирач на Python

 

Код сумісний із Python 3.8+. Установіть `requests` і задайте ключ у змінній середовища `JSONSCRAPER_TIKTOK_LICENSE_KEY`. Скрипт записує відповіді пошуку та коментарів в окремі JSON-файли, пов’язуючи кожну відповідь із коментарями із запитом і URL-адресою відео. Поля коментарів навмисно не вилучаються, доки ви не перевірите фактичну структуру відповіді.



![Стаття: Як перетворити коментарі TikTok на чергу продуктових багів
Короткий опис: Пайплайн на Python поєднує пошук відео TikTok із запитом коментарів через jsonscraper. Приклад зберігає та виводить необроблений JSON, не припускаючи заздалегідь назв полів коментарів.
Роль зображення: обкладинка — головна ідея
Розділ: Мінімальний збирач на Python
Візуальна тема: Редакційна документальна фотографія роздрукованої відповіді raw JSON поруч із картками, що позначають URL-адреси відео й коментарі, підготовленими для продуктової команди](https://jsonscraper.com/assets/uploads/journal/2026/11/90f31ffdc4a020d2bacccfeef5317f4e.png.hero.webp)

Необроблена відповідь зберігає вихідні дані для перевірки структури до нормалізації.© jsonscraper · створено за допомогою ШІ

 

```
import json
import os
from pathlib import Path

import requests

BASE = "https://tiktok.evelode.com"
KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
OUT = Path("tiktok_raw")
OUT.mkdir(exist_ok=True)


def get_json(path, params):
    response = requests.get(
        BASE + path,
        params={**params, "license_key": KEY},
        timeout=30,
    )
    response.raise_for_status()
    data = response.json()
    if data.get("status") != "ok":
        raise RuntimeError("API returned non-ok status")
    return data


def videos_from_search(data):
    tiktok = data.get("tiktok") or {}
    found = list(tiktok.get("aweme_list") or [])
    for item in tiktok.get("search_item_list") or []:
        aweme = (item or {}).get("aweme_info") or {}
        if aweme:
            found.append(aweme)

    unique = {}
    for video in found:
        video_id = video.get("aweme_id")
        video_url = video.get("share_url")
        if video_id and video_url:
            unique[video_id] = video
    return list(unique.values())


for index, keyword in enumerate(("APP_NAME ошибка", "APP_NAME не работает")):
    search = get_json("/searchVideo", {"keyword": keyword, "count": 10})
    (OUT / f"search_{index}.json").write_text(
        json.dumps(search, ensure_ascii=False, indent=2), encoding="utf-8"
    )

    for video in videos_from_search(search):
        video_id = video["aweme_id"]
        video_url = video["share_url"]
        comments = get_json(
            "/getCommentsByUrl",
            {"video_url": video_url, "count": 30},
        )
        filename = f"comments_{video_id}.json"
        record = {
            "keyword": keyword,
            "video_id": video_id,
            "video_url": video_url,
            "response": comments,
        }
        (OUT / filename).write_text(
            json.dumps(record, ensure_ascii=False, indent=2), encoding="utf-8"
        )
        print(json.dumps(record, ensure_ascii=False, indent=2))
```

 

Скрипт перевіряє зовнішній статус відповіді, а потім записує повний об’єкт JSON. Це дає змогу оглянути реальні ключі, типи значень і вкладеність, перш ніж створювати таблицю коментарів. Якщо API повернув помилку, код зупиняється та повідомляє про неї, а не мовчки зберігає некоректний результат.

 

## Як перейти від необробленого JSON до черги тем

 

Після перевірки однієї або кількох відповідей створіть нормалізатор відповідно до фактично виявленої схеми. Зберігайте вихідний JSON поряд із нормалізованими рядками, щоб можна було перевірити перетворення й повторно обробити дані після зміни коду. У записі варто залишати посилання на відео, вихідний запис коментаря, час збирання та застосовану версію правила маркування.

 

Для тематичного маркування можна почати з міток на кшталт «помилка», «запитання щодо використання», «запит на функцію», «відгук» і «не стосується продукту». Правила на основі ключових слів або класифікатор допомагають сортувати вибірку; зберігайте присвоєну мітку окремо від вихідного тексту. Перш ніж створювати завдання, фахівець має перевірити контекст коментаря та оригінальне відео.

 

Під час дедуплікації використовуйте поле ідентифікатора лише після того, як підтвердите його наявність у відповіді. Якщо ідентифікатора в даних немає, тимчасовим ключем може бути поєднання URL-адреси відео та нормалізованого тексту; цей спосіб об’єднує однакові формулювання в межах одного ролика, але не встановлює, що записи належать одному автору.

 

## Автоматизація та походження даних

 

Запускайте збирання за розкладом через cron, GitHub Actions або n8n. Зберігайте ключ у секретах середовища виконання й не додавайте його до репозиторію, файлів результатів або журналів. Залишайте вихідні відповіді JSON доступними для перевірки; визначте термін зберігання та права доступу відповідно до вимог вашої команди й застосовних правил платформи.

 

Для контролю роботи пайплайна записуйте кількість успішних пошукових запитів, знайдених унікальних відео, збережених відповідей коментарів і помилок API. Ці технічні показники показують, на якому етапі змінився результат. Порожня відповідь, помилка запиту та відсутність збігів після тематичної класифікації — це різні стани, тож зберігайте їх окремо.

 

Для бази даних зручно розділити сутності збирання, відео, вихідних відповідей із коментарями та рішень тематичного маркування. Зв’язок із запитом і відео дасть змогу відкрити джерело для ручної перевірки. Після підтвердження схеми можна додати пагінацію за курсором: маршрут приймає `cursor`, а наступний запит має передавати повернуте API значення без спроб його інтерпретувати.

 

## Що дає такий підхід

 

Команда отримує відтворюваний процес збирання та набір джерел, який можна перевірити й використати для створення черги тем. Аналітик може простежити, який пошуковий запит привів до ролика та яку відповідь із коментарями було збережено. Після перевірки структури розробник зможе додати нормалізацію й тематичне групування, не підмінюючи невідому схему припущеннями.

 

У звіті вказуйте пошукові фрази, дату запуску, критерії відбору та кількість оброблених відповідей. Висновки стосуються конкретних запитів і отриманих даних; вони допомагають досліджувати виявлені обговорення й планувати перевірку, зберігаючи їхнє походження та контекст.

 

Почніть з одного продукту та кількох діагностичних запитів: збережіть відповіді, перевірте структуру коментарів, а потім додавайте до нормалізатора лише підтверджені поля. Параметри маршрутів описані в [документації API](https://github.com/jsonscraper/tiktok-api-python/blob/main/docs/endpoints.md), а інформацію про продукт наведено на сторінці [TikTok Scraper API](https://jsonscraper.com/services/tiktok-scraper-api).
