Jak najít videa na TikToku s otázkami o vašem produktu a sestavit z nich report

Pokud zákazníci diskutují o vašem produktu na TikToku, vyhledávání podle názvu značky může týmu poskytnout podklady pro seznam opakujících se dotazů. Praktickým výsledkem je CSV s popisem videa, autorem, odkazem a dostupnými metrikami reakcí. Soubor lze předat pracovníkovi podpory nebo použít jako vstup pro tematickou klasifikaci.

Jako příklad použijeme dotaz „jak používat kávovar Acme“. Níže uvedený skript provede jeden požadavek na vyhledávání TikToku, opatrně vytáhne videa ze dvou zdokumentovaných variant struktury odpovědi a uloží nalezené výsledky. Tým pak ručně zkontroluje popisky, sloučí podobné formulace a převede je na témata FAQ nebo tipy pro produktovou stránku.

Proč převést výsledky vyhledávání do tabulky

Ruční procházení výsledků ztěžuje opakovanou kontrolu: výsledky je nutné znovu vyhledávat a poznámky často zůstávají v prohlížeči nebo v konverzaci. Ukládaná tabulka poskytne jednotný pracovní seznam: každý záznam obsahuje ID videa, odkaz, popis, autora a dostupné metriky. Opakované spuštění lze naplánovat a archiv JSON pomůže zjistit, co přesně API při konkrétním spuštění vrátilo.

Důležité je znát hranice této metody: vyhledávání vrací nalezené výsledky pro daný dotaz, nikoli zaručený úplný katalog všech zmínek. Tabulka se proto hodí k objevování příkladů a sledování opakujících se otázek; závěry o četnosti je vhodné podložit opakovanými spuštěními a ruční kontrolou.

Co vyhledávání vrací

Podle dokumentace TikTok Scraper API přijímá endpoint /searchVideo povinný parametr keyword. Mezi podporovanými parametry jsou také count, cursor, date_posted, sort_by a region. Pro tento scénář stačí hledaný výraz a počet výsledků.

Odpověď obsahuje vnější stav a objekt tiktok. V ověřeném schématu mohou být videa buď v aweme_list, nebo v položkách search_item_list uvnitř pole aweme_info. Kód počítá s oběma podobami a vytahuje pouze pole, která jsou skutečně k dispozici. Podle výsledku jsou dostupné ID videa, popis, odkaz, jméno a ID autora, datum zveřejnění a také počty zhlédnutí, lajků, komentářů a sdílení.

Jednoduchý sběrač v Pythonu

Nainstalujte knihovnu requests a nastavte klíč v proměnné prostředí JSONSCRAPER_TIKTOK_LICENSE_KEY. Kód je kompatibilní s Pythonem 3.8 a novějším. Uloží původní odpověď do JSON a normalizované záznamy do CSV. Tajný klíč se předává v požadavku, ale nevypisuje se na obrazovku.

import csv
import json
import os
from datetime import datetime, timezone
from pathlib import Path

import requests

API_KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
KEYWORD = "Acme кофемашина"

response = requests.get(
    "https://tiktok.evelode.com/searchVideo",
    params={
        "license_key": API_KEY,
        "keyword": KEYWORD,
        "count": 30,
        "region": "US",
    },
    timeout=60,
)
response.raise_for_status()
payload = response.json()

if payload.get("status") != "ok":
    raise RuntimeError("TikTok API vrátilo neočekávaný vnější stav")

tiktok = payload.get("tiktok") or {}
items = list(tiktok.get("aweme_list") or [])
for result in tiktok.get("search_item_list") or []:
    video = result.get("aweme_info")
    if video:
        items.append(video)

# Odstraníme duplicity a zachováme pořadí prvního výskytu.
unique = {}
for item in items:
    video_id = item.get("aweme_id")
    if video_id:
        unique.setdefault(video_id, item)

stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
Path("data").mkdir(exist_ok=True)
Path(f"data/raw-{stamp}.json").write_text(
    json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8"
)

columns = [
    "video_id", "description", "share_url", "author", "author_id",
    "created_at", "views", "likes", "comments", "collected_at"
]
with open("data/videos.csv", "w", newline="", encoding="utf-8") as file:
    writer = csv.DictWriter(file, fieldnames=columns)
    writer.writeheader()
    for item in unique.values():
        author = item.get("author") or {}
        stats = item.get("statistics") or {}
        created = item.get("create_time")
        writer.writerow({
            "video_id": item.get("aweme_id"),
            "description": item.get("desc"),
            "share_url": item.get("share_url"),
            "author": author.get("nickname"),
            "author_id": author.get("uid"),
            "created_at": created,
            "views": stats.get("play_count"),
            "likes": stats.get("digg_count"),
            "comments": stats.get("comment_count"),
            "collected_at": stamp,
        })

print(f"Uloženo záznamů: {len(unique)}")

Závislost nainstalujete příkazem python -m pip install requests. Pokud některé pole v konkrétním záznamu chybí, kód ponechá odpovídající buňku prázdnou. U metrik je to důležité: prázdná hodnota znamená, že pole nebylo vráceno, a nenahrazuje se nulou.

Jak z CSV vytvořit užitečný seznam otázek

Prvním krokem je filtrování podle obsahu popisku. Lze vyhledávat výrazy jako „jak“, „proč“, „nefunguje“, název modelu nebo charakteristické názvy součástí. Takový filtr vytvoří frontu pro redakční kontrolu, sám o sobě však neurčuje záměr autora: zmínka o značce může být recenzí, vtipem nebo dotazem na kompatibilitu.

Při tematickém seskupování předávejte klasifikátoru pouze nezbytná textová pole: popis a případně, pokud je to pro daný úkol vhodné, anonymizovaný identifikátor záznamu. Požádejte jej o přiřazení pevně daných kategorií, například „první spuštění“, „čištění“, „kompatibilita“, „závada“ a „nákup“. Původní popis uchovávejte vedle kategorie, aby pracovník mohl přiřazení zkontrolovat a případnou chybu opravit.

Pracovní report může obsahovat téma, počet nalezených příkladů, odkazy na několik ilustračních videí a samostatný sloupec „ověřeno člověkem“. Počet příkladů v shromážděném souboru popisuje výsledky tohoto dotazu a období sběru; neodpovídá podílu všech zákazníků, kteří se potýkají s daným problémem.

Stránkování a pravidelné spouštění

Pokud potřebujete další stránku výsledků, dokumentace uvádí cursor jako parametr stránkování: hodnotu kurzoru z předchozí odpovědi předejte v následujícím požadavku. Považujte ji za neprůhledný token a procházení ukončete, když už odpověď neobsahuje žádné výsledky nebo API oznámí, že další stránka není k dispozici. U omezeného pilotního provozu je rozumné začít jedním požadavkem, zkontrolovat složení výsledků a teprve poté přidat stránkování.

Pravidelný sběr zajistíte spuštěním skriptu podle plánu prostřednictvím plánovače operačního systému nebo CI. Pro každé spuštění ukládejte samostatný původní JSON a do tabulky přidávejte čas sběru. Při hromadění historie odstraňujte duplicity podle ID videa, ale opakované záznamy ukládejte samostatně, pokud potřebujete sledovat měnící se metriky. Porovnávat metriky má smysl pouze tehdy, máte-li k dispozici několik snímků téhož záznamu.

Klíč ukládejte do správce tajných údajů CI nebo do proměnné prostředí, omezte přístup k archivu a stanovte interní dobu uchovávání. Před předáním materiálů klasifikačnímu systému ověřte, která pole skutečně potřebuje. Omezíte tím zbytečné kopírování uživatelských údajů a usnadníte řízení přístupu.

Jaký výsledek tým získá

Po spuštění budete mít archiv původní odpovědi a CSV s nalezenými videi a dostupnými poli. Podpora může kontrolovat odkazy a shromažďovat opakující se otázky; marketing může sledovat, jak publikum popisuje své potřeby; analytik může sběr opakovat a porovnávat pozorování z různých dat.

Začněte úzkým dotazem s názvem produktu a konkrétním problémem, ručně zkontrolujte 20–30 nalezených záznamů a upravte slovník kategorií. Poté můžete přidat několik tematických dotazů, plánované spouštění a export do tabulky nebo databáze. Možnosti endpointu a jeho parametry jsou uvedeny v popisu TikTok Scraper API; než začnete budovat rozsáhlejší monitoring, nejprve ověřte zvolený dotaz.