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.

- Vyhledání: vyhledejte videa podle klíčové fráze a ověřte obě podporované struktury výsledků.
- Výběr: zvolte relevantní videa a uložte jejich identifikátory a URL.
- Sběr komentářů: předejte URL endpointu pro komentáře; při pokračování stránkování použijte vrácený kurzor.
- Ověření: uložte surový JSON a podle odpovědi zjistěte skutečné názvy polí.
- Analýza: po ověření schématu seskupte texty a předejte ukázky člověku ke kontrole.
Které endpointy použít
Dokumentace TikTok Scraper API 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.

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 a informace o produktu najdete na stránce TikTok Scraper API.