# Jak proměnit komentáře na TikToku v seznam produktových chyb

https://jsonscraper.com/cs/blog/komentare-tiktok-produktove-chyby-pipeline

Author: Michael Johnson

Published: 2026-11-18T11:39:19+00:00

Updated: 2026-11-18T11:39:19+00:00

Najděte videa, stáhněte k nim veřejné komentáře a uložte původní JSON, abyste před tematickým označováním ověřili skutečnou strukturu odpovědi.

Chcete-li prozkoumat diskusi o problému na TikToku, nejprve vyhledejte vhodná videa a poté si ke každému vybranému videu vyžádejte komentáře. Výsledkem pro produktový tým může být sada původních odpovědí JSON propojených s vyhledávacím dotazem a odkazem na video. Než začnete vytvářet tematický seznam, ověřte skutečnou strukturu komentářů: dokumentace potvrzuje endpoint a jeho parametry, nepopisuje však pole v záznamech odpovědi.

 

Jde o důležitou fázi analytického pipeline. Výsledky vyhledávání pomáhají shromáždit kontext týkající se produktu a komentáře mohou obsahovat hlášení o chybách, dotazy nebo alternativní postupy. Aby klasifikace vycházela ze skutečných dat, nejprve uložte odpověď API beze změn a potom porovnejte její pole se skutečně získaným schématem.

 

## Proč samotné vyhledávání videí nestačí

 

Název aplikace nebo zařízení pomůže najít videa, ale jejich popis zachycuje především formulaci autora. Diváci mohou v komentářích probírat konkrétní závady a způsoby používání. Sběr komentářů proto přidává k výsledkům vyhledávání druhou úroveň dat propojenou s původním videem.

 

Dřívější články se věnovaly sledování vyhledávání na TikToku, získávání otázek z popisů a zpracování odpovědí vyhledávání. Tento článek řeší užší úkol: shromáždit odpovědi z endpointu pro komentáře a ověřit jejich strukturu ještě před návrhem klasifikace. Hodí se vývojářům analytických integrací, výzkumníkům uživatelské zkušenosti i týmům podpory.

 

## Od vyhledávacího dotazu k ověřitelné datové sadě

 

Zadejte několik konkrétních dotazů, například název produktu spolu s názvem funkce nebo modelu. Uložte odpověď vyhledávání i URL vybraných videí. Poté podle URL vyžádejte komentáře a každou původní odpověď uložte zvlášť. Po ověření schématu můžete normalizovat potřebná pole, odstraňovat duplicity a seskupovat texty podle témat.



![Článek: Jak proměnit komentáře na TikToku v seznam produktových chyb
Shrnutí: Pythonový pipeline propojuje vyhledávání videí na TikToku se získáváním komentářů přes jsonscraper. Ukázka ukládá a vypisuje surový JSON, aniž by předem předpokládala názvy polí komentářů.
Role obrázku: doprovodná ilustrace 2 — jiný konkrétní aspekt
Sekce: Od vyhledávacího dotazu k ověřitelné datové sadě
Vizuální téma: Infografika v ruštině znázorňující postup: vyhledání podle klíčového slova → výběr videa → vyžádání komentářů](https://jsonscraper.com/assets/uploads/journal/2026/11/0fd7e8fd8c3e0ddec431e375056cca1b.png.hero.webp)

Schéma odděluje zdokumentované kroky sběru od normalizace, která následuje po ověření skutečné odpovědi.© jsonscraper · ilustrace vytvořená pomocí AI

 

1. **Vyhledání:** vyhledejte videa podle klíčové fráze a ověřte obě podporované struktury výsledků.
2. **Výběr:** zvolte relevantní videa a uložte jejich identifikátory a URL.
3. **Sběr komentářů:** předejte URL endpointu pro komentáře; při pokračování stránkování použijte vrácený kurzor.
4. **Ověření:** uložte surový JSON a podle odpovědi zjistěte skutečné názvy polí.
5. **Analýza:** po ověření schématu seskupte texty a předejte ukázky člověku ke kontrole.

 

Schéma: vyhledání videí na TikToku, výběr videí, vyžádání komentářů, uložení původního JSON, ověření struktury a ruční tematické označení

Nejprve ukládejte celou odpověď; normalizaci přidávejte až po ověření skutečných polí.

 

## Které endpointy použít

 

[Dokumentace TikTok Scraper API](https://github.com/jsonscraper/tiktok-api-python/blob/main/docs/endpoints.md) popisuje `GET /searchVideo` s povinným parametrem `keyword`. Mezi další parametry patří `count`, `cursor`, `date_posted`, `sort_by` a `region`. Pro komentáře slouží `GET /getCommentsByUrl` s povinným parametrem `video_url`; mezi další uvedené parametry patří `cursor`, `count` a `region`. Klíč se předává v parametru `license_key`.

 

V odpovědi vyhledávání se videa mohou nacházet v `tiktok.aweme_list` nebo v `tiktok.search_item_list[].aweme_info`. Ukázka zpracovává oba formáty, kontroluje vnější stav a ukládá nalezené objekty. U odpovědi s komentáři nepředpokládá název pole pro pole ani názvy jeho položek: přijatý JSON uloží a vypíše, aby jej bylo možné zkontrolovat.

 

## Jednoduchý sběrač v Pythonu

 

Kód je kompatibilní s Pythonem 3.8 a novějším. Nainstalujte `requests` a nastavte klíč v proměnné prostředí `JSONSCRAPER_TIKTOK_LICENSE_KEY`. Skript zapisuje odpovědi vyhledávání a komentářů do samostatných souborů JSON a každou odpověď s komentáři propojuje s dotazem a URL videa. Pole komentářů záměrně neextrahuje, dokud neověříte skutečnou strukturu odpovědi.



![Článek: Jak proměnit komentáře na TikToku v seznam produktových chyb
Shrnutí: Pythonový pipeline propojuje vyhledávání videí na TikToku se získáváním komentářů přes jsonscraper. Ukázka ukládá a vypisuje surový JSON, aniž by předem předpokládala názvy polí komentářů.
Role obrázku: titulní obrázek — ústřední myšlenka
Sekce: Jednoduchý sběrač v Pythonu
Vizuální téma: Dokumentární redakční fotografie vytištěné surové odpovědi JSON vedle karet znázorňujících URL videí a komentáře, uspořádaných pro produktový tým](https://jsonscraper.com/assets/uploads/journal/2026/11/90f31ffdc4a020d2bacccfeef5317f4e.png.hero.webp)

Surová odpověď uchovává původní data, aby bylo možné ověřit strukturu ještě před normalizací.© jsonscraper · vytvořeno pomocí AI

 

```
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))
```

 

Skript kontroluje vnější stav odpovědi a následně zapisuje celý objekt JSON. Díky tomu můžete prohlédnout skutečné klíče, typy hodnot a vnoření ještě před vytvořením tabulky komentářů. Pokud API vrátí chybu, kód se zastaví a oznámí ji, místo aby potichu uložil neplatný výsledek.

 

## Jak přejít od surového JSON k tematickému seznamu

 

Po kontrole jedné nebo více odpovědí vytvořte normalizátor podle skutečně zjištěného schématu. Původní JSON uchovávejte vedle normalizovaných řádků, abyste mohli ověřit transformaci a data znovu zpracovat, pokud se kód změní. V záznamu je užitečné ponechat odkaz na video, původní záznam komentáře, čas sběru a použitou verzi pravidla označování.

 

Pro tematické označování můžete začít štítky jako „chyba“, „dotaz k používání“, „požadavek na funkci“, „zpětná vazba“ a „netýká se produktu“. Pravidla založená na klíčových slovech nebo klasifikátor pomohou roztřídit vzorek; přiřazený štítek ukládejte odděleně od původního textu. Před vytvořením úkolu by měl specialista zkontrolovat kontext komentáře i původní video.

 

Při odstraňování duplicit použijte pole s identifikátorem až poté, co ověříte, že se v odpovědi skutečně nachází. Pokud data identifikátor neobsahují, může dočasný klíč tvořit URL videa spolu s normalizovaným textem; tento postup sloučí stejné formulace v rámci jednoho videa, ale nepotvrzuje, že záznamy pocházejí od stejného autora.

 

## Automatizace a původ dat

 

Sběr spouštějte podle plánu přes cron, GitHub Actions nebo n8n. Klíč uchovávejte v tajných proměnných běhového prostředí a nezahrnujte jej do repozitáře, výstupních souborů ani protokolů. Původní odpovědi JSON ponechte dostupné ke kontrole; dobu uchovávání a přístupová oprávnění nastavte podle požadavků svého týmu a platných pravidel platformy.

 

Pro sledování funkčnosti pipeline zaznamenávejte počet úspěšných vyhledávacích dotazů, nalezených jedinečných videí, uložených odpovědí s komentáři a chyb API. Tyto technické ukazatele ukazují, v které fázi se výsledek změnil. Prázdná odpověď, chyba požadavku a absence shod po tematické klasifikaci jsou různé stavy, proto je evidujte odděleně.

 

V databázi je vhodné oddělit entity sběru, videí, původních odpovědí s komentáři a rozhodnutí o tematickém označení. Propojení s dotazem a videem umožní otevřít zdroj pro ruční kontrolu. Po potvrzení schématu můžete přidat stránkování pomocí kurzoru: endpoint přijímá `cursor` a při dalším požadavku je třeba předat hodnotu vrácenou API, aniž byste se ji pokoušeli interpretovat.

 

## Co tento přístup přináší

 

Tým získá opakovatelný proces sběru a ověřitelnou sadu zdrojů, z níž lze vytvořit tematický seznam. Analytik může dohledat, který vyhledávací dotaz vedl k videu a která odpověď s komentáři byla uložena. Po ověření struktury může vývojář přidat normalizaci a tematické seskupování, aniž by neznámé schéma nahrazoval domněnkami.

 

V reportu uveďte vyhledávací fráze, datum spuštění, kritéria výběru a počet zpracovaných odpovědí. Závěry se vztahují ke konkrétním dotazům a vráceným datům; pomáhají zkoumat nalezené diskuse a plánovat ověření, přičemž zachovávají jejich původ i kontext.

 

Začněte s jedním produktem a několika diagnostickými dotazy: uložte odpovědi, ověřte strukturu komentářů a do normalizátoru pak přidejte pouze potvrzená pole. Parametry endpointů popisuje [dokumentace API](https://github.com/jsonscraper/tiktok-api-python/blob/main/docs/endpoints.md) a informace o produktu najdete na stránce [TikTok Scraper API](https://jsonscraper.com/services/tiktok-scraper-api).
