Vyhledávání na GitHubu pro výraz „tiktok scraper“ vrací 339 repozitářů. Zhruba 48 % z nich nebylo aktualizováno déle než rok a nejméně 4 jsou výslovně archivované.
Pokud jste někdy klonovali populární repozitář na TikTok scraping, strávili hodinu řešením závislostí a pak dostali nulový výstup, nejste v tom sami. Nejvíc hvězdiček na GitHubu má pořád drawrowfly/tiktok-scraper s více než 5 000 hvězdičkami. Jenže v issues narazíte na vlákna jako #812: „is this amazing tool still working?“ a #824: „Is this still working?“ — obě hlásí nulový výstup. V Thunderbit sleduji stav TikTok scraping repozitářů už měsíce a vzorec je jasný: tyhle nástroje se rozbijí rychle a většina se už nikdy neopraví. Tenhle článek je praktický průvodce přežitím, který jsem si přál mít, když jsem tyto repozitáře začínal hodnotit. Projdeme, co ještě žije, co už je mrtvé, co použít místo toho a jak přestat ztrácet hodiny na kódu, který přestal fungovat dřív, než jste ho vůbec našli.
Proč se většina TikTok scraperů na GitHubu rozbije (a rozbíjí pořád dokola)
TikTok není běžný cíl pro scraping. Jeho webové rozhraní se neustále mění. Na rozdíl od statické produktové stránky e-shopu nebo seznamu v adresáři TikTok průběžně mění endpointy, aktualizuje anti-bot fingerprinting, upravuje způsob renderování stránek a zavádí nové požadavky na session/tokeny — někdy během několika týdnů od poslední změny.
Open-source maintainers jsou dobrovolníci. Když TikTok vydá update, který rozbije request flow scraperu, repozitář může zůstat nefunkční dny, týdny nebo natrvalo. Není to výtka vůči maintainerům — je to strukturální nesoulad mezi rychle se měnící, dobře financovanou platformou a neplacenými vývojáři, kteří mají vlastní práci.
I ty nejlepší TikTok scraper repozitáře jedou v režimu „rozbije se — opraví se“. Pokud ho chcete použít, potřebujete strategii pro vyhodnocení, troubleshooting i záložní plán.
TikTokova anti-bot ochrana: s čím bojujete
- Rate limiting. Oficiální developer docs TikToku výslovně popisují limity requestů i pro schválené integrace. Neoficiální scrapers na tyto limity narážejí mnohem rychleji.
- Cookies a session gating. Moderní repozitáře jako davidteather/TikTok-Api vyžadují
ms_token; starší repozitáře jako drawrowfly/tiktok-scraper ukazují v příkladechtt_webid_v2; Evil0ctal/Douyin_TikTok_Download_API dokumentujemsToken,ttwid,X-BogusaA_Bogus. TikTok kontroluje, jestli request vypadá jako součást reálné browsing session. - Browser fingerprinting. Průvodce antibot ochranou od ScrapFly vysvětluje, proč weby porovnávají hlavičky, cookies, TLS signatury a vlastnosti browseru dostupné přes JavaScript s provozem skutečných uživatelů. Jejich rozbor browser fingerprintingu popisuje Canvas, WebGL, WebRTC, fonty i runtime signály. Fingerprinting je jako kontrola občanky vašeho prohlížeče — když browser, cookies, timing a síťový otisk nesedí dohromady, request působí falešně ještě před tím, než se vrátí jakýkoli obsah.
- Behaviorální detekce. Diskuse na Redditu o TikTok scrapingu často zmiňují, že nové Playwright session spouštějí CAPTCHA. Komunitní příspěvky z let 2025–2026 čím dál častěji popisují detekci, která sleduje načasování akcí a kvalitu interakce, nejen opakované použití IP adresy.
- Šifrované/podepsané parametry requestů. Evil0ctal dokumentuje
X-BogusaA_Bogus; starší komunitní gisty se točí kolem signování URL a generování tokenů. TikTok stále víc očekává, že requesty dorazí se stejnými „razítky“, jaká nesou jeho vlastní web/app requesty. - CAPTCHA a verifikační flow. Existence TikTok-specific CAPTCHA solver repozitářů a diskusí na Redditu o puzzle challenge potvrzuje, že CAPTCHA zůstává součástí anti-bot ochrany.
Proč open-source maintainers nestíhají
Životní cyklus je pokaždé stejný. Vývojář vytvoří TikTok scraper. Na GitHubu se stane virálním. TikTok ho zablokuje. Maintainer buď opraví, nebo odchází.
Dva repozitáře tenhle vzorec ukazují úplně přesně:
- drawrowfly/tiktok-scraper má pořád 5 052 hvězdiček a 889 forků, ale jeho poslední push byl 19. května 2023. Je to nejpopulárnější přesný TikTok scraper na GitHubu podle hvězdiček a dnes působí spíš jako historický artefakt: vysoká viditelnost, vysoká důvěra, žádná aktuální údržba.
- davidteather/TikTok-Api má 6 301 hvězdičku, 1 177 forků a poslední push 1. dubna 2026. Jeho release feed ukazuje skutečnou údržbu v dubnu 2025, červenci 2025, říjnu 2025 a dubnu 2026 — včetně oprav pro crawling uživatelských videí a nových proxy/session kontrol. Ale i tenhle zdravější projekt otevřeně upozorňuje, že TikTok requesty blokuje a uživatelé mohou potřebovat proxy, Playwright a vlastní session logiku.
Vzorec je jednoduchý:
- Zastaralý TikTok scraper repozitář je pravděpodobně mrtvý.
- Aktivní TikTok scraper repozitář je pravděpodobně pořád křehký.
- Jediný skutečný rozdíl je, jestli je tu ještě někdo, kdo ten rozbitý kód tento měsíc opraví.
60sekundový checklist životaschopnosti repozitáře: jak vyhodnotit jakýkoli TikTok scraper na GitHubu
Než cokoli naklonujete, projděte si tenhle checklist. Zabere méně než minutu a ušetří hodiny frustrace.
| Signál | 🟢 Zdravé | 🟡 Rizikové | 🔴 Mrtvé |
|---|---|---|---|
| Poslední smysluplný push | před méně než 3 měsíci | 3–12 měsíců | 12+ měsíců |
| Počet otevřených issues | Nízký, nové issue dostávají odpověď | Rostoucí hromada, ale něco se stále řeší | Mnoho nezodpovězených hlášení „broken/blocked/not working“ |
| Nedávné stížnosti uživatelů | Hlavně dotazy k instalaci | Smíšené dotazy k instalaci + rozbité funkce | Opakované „zero output“, „403“, „still working?“ |
| Aktuální auth/session model | Je zdokumentovaný session/cookie postup | Tokeny ano, ale aspoň zdokumentované | Spoléhá na staré web endpointy bez aktuálního auth návodu |
| Povrch instalace | Reprodukovatelný, otestovaný setup | Některé kroky je nutné dělat ručně | Staré závislosti, žádné moderní instalační poznámky |
| CI/testy | Existují a jsou aktuální | Existují, ale coverage není jasná | Žádné testy nebo zastaralé akce |
| Shoda s datovým rozsahem | Odpovídá vašemu skutečnému use casu | Podporuje jen část use casu | Řeší úplně jiný problém |
Jak každý signál zkontrolovat za méně než 60 sekund
- Datum posledního push: Podívejte se na hlavičku repozitáře na GitHubu. Pokud je tam „last pushed 2 years ago“, máte hotovo.
- Otevřená issue: Klikněte na kartu Issues. Projděte si nejnovější názvy. Hledejte
not working,403,blocked,captchanebozero output. - Stížnosti uživatelů: Pokud je pět nejnovějších otevřených issues jen variace na „už to nefunguje“, máte odpověď.
- Auth/session model: Otevřete README. Hledejte aktuální doporučení jako
ms_token, Playwright setup nebo poznámky k proxy. Pokud README odkazuje na endpointy z roku 2023, jděte dál. - Povrch instalace: Zkontrolujte soubor s požadavky, podporu Dockeru nebo jasný postup instalace. Pokud README říká jen „npm install“ a poslední testovaná verze Node je 14, čekejte problémy.
- CI/testy: Podívejte se na kartu Actions. Pokud testy padají nebo chybí, je breakage jen hádání.
- Shoda s datovým rozsahem: Opravdu repozitář popisuje typy dat, které potřebujete (profily, metadata videí, komentáře, hashtagy)? Mnoho repozitářů umí jen stahování videí, ne strukturovanou extrakci dat.
Varovné signály, které znamenají „ruce pryč“
- Repozitář je archivovaný.
- README říká „no longer maintained“.
- Poslední commit odkazuje na verzi TikTok API starou 2+ let.
- Issues jsou zaplavené hlášeními „doesn't work“ a maintainer měsíce nereagoval.
- Repozitář má hodně hvězdiček, ale žádné nedávné forky ani pull requesty.
Tip: V Issues tabu vyhledejte is:issue is:open "not working" nebo is:issue is:open "403". Pokud jsou výsledky husté a čerstvé, repozitář je nejspíš rozbitý.
Populární GitHub repozitáře pro TikTok scraper: upřímná kontrola stavu (2026)
Tady je checklist životaschopnosti repozitáře aplikovaný na projekty, které skutečně najdete při hledání „tiktok scraper“ na GitHubu:
| Repozitář | Poslední push | Hvězdičky | Otevřené issues | Verdikt | Poznámka |
|---|---|---|---|---|---|
| drawrowfly/tiktok-scraper | 2023-05-19 | 5 052 | 58 | 🔴 Mrtvý / jen jako reference | Pořád slavný, ale pro produkční použití v roce 2026 už příliš zastaralý |
| davidteather/TikTok-Api | 2026-04-01 | 6 301 | 134 | 🟡 Žije, ale vyžaduje hodně údržby | Nejlepší OSS volba; očekává Playwright, tokeny a často i proxy |
| scrapfly/scrapfly-scrapers/tiktok-scraper | 2026-04-21 | 938 (parent) | ~0 (monorepo) | 🟡 Žije, ale není to čistě OSS | Aktuální a užitečné, ale vyžaduje API klíč ScrapFly |
| Evil0ctal/Douyin_TikTok_Download_API | 2025-10-12 | 17 397 | 135 | 🟡 Žije, široký záběr, komplexní | Funkčně bohatý multi-platform projekt; blíž power-user platformě |
| naseif/tiktok-scraper | 2024-07-26 | 107 | 13 | 🟡 Rizikový | Menší repozitář s otevřenými stížnostmi na user info a hashtag flow |
| loewehancara1rmyv/Tiktok-scraper | 2026-01-12 | 4 | 0 | 🔴 Příliš nový na důvěru | Showcase repozitář, ne projekt ověřený komunitou |
drawrowfly/tiktok-scraper
Po léta byl tenhle TypeScript scraper/downloader výchozí odpovědí na „tiktok scraper github“ — zvládal user, trend, hashtag i music feedy. V roce 2026 je nejlepší ho vnímat jako historickou dokumentaci. Poslední push byl v květnu 2023 a fronta issues pořád obsahuje nevyřešené hlášky „still working?“ a „zero output“ z let 2023–2025. Jestli čtete tenhle článek proto, že jste tenhle repozitář naklonovali a nedostali nic, nejste sami.
davidteather/TikTok-Api
Nejvěrohodnější open-source wrapper pro TikTok data, který je v roce 2026 stále živý. Je aktivní, má nedávné releasy a explicitně dokumentuje Playwright setup, async použití, práci s tokeny, podporu proxy i funkce pro obnovu session. Není to ale nástroj typu „naklonuj a běž“. V README samotném se píše, že EmptyResponseException obvykle znamená, že TikTok request blokuje, a historie diskusí ukazuje opakované potíže s ms_token, rozbitou extrakcí komentářů, KeyError: 'ItemModule' i chybami specifickými pro jednotlivé endpointy. Verdikt: živý, užitečný, pro vývojáře a náročný na údržbu.
Další pozoruhodné repozitáře
- scrapfly/scrapfly-scrapers/tiktok-scraper: Aktuální a technicky relevantní, ale README vyžaduje
SCRAPFLY_KEY. Jde o ukázkový kód pro spravovanou scraping platformu, ne o bezplatný samostatný nástroj. - Evil0ctal/Douyin_TikTok_Download_API: Pokrývá TikTok i Douyin, dokumentuje signovací logiku (
X-Bogus,A_Bogus,msToken) a podporuje komentáře, followery, playlisty a další. Je technicky náročný a čím dál víc propojený s placenými API odkazy. Issues tracker ukazuje průběžné bug reporty v roce 2026 kolem video linků a endpointů pro user info. Živý a bohatý na funkce, ale komplexní. - naseif/tiktok-scraper: Menší projekt s otevřenými stížnostmi. Pro produkční použití je rizikový.
- loewehancara1rmyv/Tiktok-scraper: 4 hvězdičky, 0 issues, příliš nový na důvěru. Medium článek, který ho propagoval, to prezentoval nekriticky.
Oficiální TikTok API vs. GitHub scrapery vs. no-code nástroje: rozhodovací rámec
Většina konkurenčních článků buď ignoruje oficiální přístupové cesty TikToku, nebo přejde rovnou z „použij GitHub“ na „kup si naše služby“. Tady je neutrální srovnání všech tří možností:
| Faktor | TikTok Research API | GitHub scrapery | No-code nástroje (např. Thunderbit) |
|---|---|---|---|
| Bariéra přístupu | Je potřeba akademická / firemní žádost; schválení trvá cca 4 týdny | Git clone + instalace | Instalace rozšíření do prohlížeče |
| Datový rozsah | Jen schválené endpointy (účty, videa, komentáře, shopy) | Široký (profily, videa, komentáře, hashtagy, shopy) | Viditelná data na stránce (profily, videa, engagement, hashtagy) |
| Nároky na údržbu | Nízké (oficiální, stabilní) | Vysoké (repozitáře se rozbíjejí při změnách TikToku) | Žádné (AI se přizpůsobuje změnám rozložení) |
| Riziko banů | Žádné (autorizované) | Vysoké | Nízké (běží v prohlížeči, napodobuje skutečného uživatele) |
| Cena | Zdarma (pokud jste schváleni) | Zdarma (ale časově náročné) | K dispozici free tier; tarify od 15 $/měsíc |
| Nutnost programování | Ano (Python/R) | Ano (Python/Node.js) | Ne |
| Nejlepší pro | Výzkumníky, akademiky, schválené organizace | Vývojáře, kteří zvládnou údržbu | Marketers, obchodní týmy, ops, neprogramátory |
Kdy dává smysl TikTok Research API
Research API od TikToku je nejčistší oficiální cesta, pokud na ni dosáhnete. Oprávnění výzkumníci v USA, Evropě a Brazílii mohou žádat o přístup ke studiu veřejného obsahu a dat účtů. Mezi dostupné kategorie dat patří účty, follower/following, lajkovaná videa, připnutá videa, repostovaná videa, obsah, komentáře a shopy. Codebook zpřístupňuje pole jako video_description, view_count, like_count, comment_count, share_count a na úrovni komentářů text, reply_count a create_time.
Nevýhoda: způsobilost je omezená na akademické instituce a oprávněné neziskové / nezávislé výzkumníky v určitých regionech, plus prověřené výzkumníky v rámci procesu DSA EU. Pokud jste growth tým nebo agentura, která potřebuje rychlá provozní data, tohle není vaše cesta.
TikTok nabízí také Commercial Content API pro reklamy a data o obsahu inzerentů, což je užitečné pro research transparentnosti, ale ne pro obecný scraping.
Kdy dává smysl GitHub scraper
GitHub scrapery dávají smysl vývojářům, kteří potřebují neoficiální přístup k veřejným datům za hranicí schválení oficiálního API a jsou ochotni stack udržovat. Sem patří use case jako scraping viditelných profilových gridů, hashtagů, komentářů, playlistů nebo metadat videí v custom pipeline, kde je v pořádku repozitář forknout a opravovat.
Upřímné upozornění: není to jednorázové nastavení. I nejspolehlivější repozitář roku 2026, davidteather/TikTok-Api, pořád uživatelům říká, že mohou potřebovat Playwright, cookies/tokeny, proxy a vlastní factory pro stránky/session.
Kdy dává smysl no-code nástroj jako Thunderbit
Scrape TikTok data with AI Get Started Free
Nejste vývojář? Nebo jste vývojář, který už má dost cyklu „rozbije se — opraví se“? Browserový AI nástroj je nejrychlejší cesta ke strukturovaným TikTok datům.
Thunderbit jsme postavili jako AI web scraper ve formě Chrome rozšíření. Na TikToku přečte jakoukoli viditelnou stránku (profil, video, hashtag, výsledky hledání), navrhne sloupce přes „AI Suggest Fields“ a vy jen kliknete na „Scrape“ pro extrakci strukturovaných dat. Stránka s TikTok scraper nástrojem dokumentuje pole jako datum zveřejnění, délku videa, lajky, sdílení, uložení, komentáře, zhlédnutí a hashtagy. Šablona image scraperu ukazuje, jak z profilových stránek sbírat náhledy příspěvků, URL, popisky, handle tvůrců a engagement signály. Šablona hashtag scraperu pokrývá URL videa, username tvůrce, popis, čas zveřejnění, zhlédnutí, lajky, komentáře, sdílení, zvuk/audio a URL cover obrázku.
Subpage scraping vám umožní otevřít jednotlivé stránky videí z výpisu profilu a obohatit tabulku o engagement metriky, popisky a hashtagy — užitečné pro marketéry budující databáze influencerů nebo pro audit obsahu konkurence.
Žádná údržba, žádné řešení instalace, žádná anti-ban konfigurace. AI se automaticky přizpůsobuje změnám rozložení TikToku. Export je zdarma do Google Sheets, Excelu, Airtable, Notion, CSV nebo JSON.
Jestli jste už spálili hodiny na rozbitých GitHub repozitářích, je to legitimní alternativa — ne vynucená produktová prezentace.
Vyzkoušet Thunderbit pro TikTok scraping
Instalační triage: oprava 5 nejčastějších selhání při setupu TikTok scraperu z GitHubu
Chyby při instalaci jsou třetím nejčastěji zmiňovaným problémem v TikTok scraping fórech a žádný velký návod je ve skutečnosti neumí dobře vyřešit. Tady je, co se typicky pokazí.
Konflikty verzí Node.js
Problém: Mnoho starších TikTok scraper repozitářů (hlavně drawrowfly/tiktok-scraper) bylo postaveno pro Node.js 14–16. Pokud jedete na Node 20+, npm install může tiše selhat nebo vyrobit nekompatibilní binárky.
Řešení: Použijte nvm (Node Version Manager) k instalaci a přepnutí na správnou verzi:
nvm install 16
nvm use 16
npm install
Pokud repozitář verzi Node neurčuje, zkontrolujte pole engines v package.json nebo se podívejte do CI konfigurace.
Problémy se závislostmi v Pythonu a setup Playwrightu
Problém: davidteather/TikTok-Api vyžaduje Python 3.9+ a Playwright se specifickými browser binárkami. Uživatelé pak dostávají chyby jako „browser not found“ nebo konflikty závislostí.
Řešení: Vždy používejte virtuální prostředí a pak explicitně nainstalujte prohlížeče Playwrightu:
python -m venv .venv
source .venv/bin/activate # Na Windows: .venv\Scripts\activate
pip install TikTokApi
python -m playwright install
Když playwright install selže, zkontrolujte správce balíčků vašeho systému kvůli chybějícím systémovým závislostem (např. libnss3 na Ubuntu).
Chyby oprávnění na Linuxu/Ubuntu
Problém: Použití sudo pip install poškodí systémové Python prostředí a způsobí řetězové problémy se závislostmi.
Řešení: Nikdy nepoužívejte sudo pip install. Nejdřív vždy vytvořte virtuální prostředí:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Tím izolujete závislosti scraperu od systémového Pythonu.
Problémy s cestami a kódováním ve Windows
Problém: Windows CMD má potíže s kódováním a omezením délky cest, což rozbíjí instalaci scraperů, hlavně když Playwright stahuje browser binárky do hluboce zanořených složek.
Řešení: Použijte WSL (Windows Subsystem for Linux) nebo Git Bash místo CMD. WSL vám dá plnohodnotné Linux prostředí uvnitř Windows:
wsl --install
# Pak otevřete WSL terminál a pokračujte podle Linux setup kroků
Docker zkratka: přeskočte problémy se závislostmi úplně
Problém: Všechno výše zmíněné.
Řešení: Pokud umíte Docker, zabalte prostředí scraperu do kontejneru. Základní Dockerfile pro Pythonový TikTok scraper vypadá takto:
FROM python:3.11-slim
RUN apt-get update && apt-get install -y libnss3 libatk-bridge2.0-0 libdrm2 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2
RUN pip install TikTokApi playwright && python -m playwright install --with-deps chromium
WORKDIR /app
COPY . .
CMD ["python", "scrape.py"]
Tím získáte reprodukovatelné prostředí bez ohledu na hostitelský OS. Pokud scraper funguje v Dockeru, jakákoli chyba mimo Docker je problém prostředí, ne kódu.
Flowchart pro troubleshooting:
- Spustí se vlastní příklad repozitáře úspěšně? → Pokud ne, zkontrolujte verzi runtime.
- Je verze runtime správná? → Zkontrolujte instalaci browseru/Playwrightu.
- Je browser nainstalovaný? → Zkontrolujte tokeny/cookies.
- Jsou tokeny/cookies platné? → Zjistěte, zda TikTok session blokuje.
- Selže všechno výše? → Předpokládejte rozbití repozitáře, ne chybu uživatele. Přepněte nástroj.
Nejlepší praktiky proti banům při TikTok scrapingu (bez placených proxy)
Uživatelé ve fórech opakovaně stěžují na bany a detekci: „dostanou vám účty zabanované, což je další náklad“ a „bez Apify nebo drahých placených API“. Tady jsou zdarma a praktické postupy, které nevyžadují placené proxy předplatné.
| Postup | Náročnost | Cena | Účinnost |
|---|---|---|---|
| Náhodné zpoždění mezi requesty (jitter 2–8 s) | Snadná | Zdarma | Střední |
| Rotace session/cookies | Střední | Zdarma | Střední |
| Scraping pouze veřejných stránek bez přihlášení | Snadná | Zdarma | Střední |
Respektování robots.txt + rate-limit hlaviček | Snadná | Zdarma | Základní |
| Náhodné fingerprinty headless browseru (Playwright) | Střední | Zdarma | Vysoká |
| Použití mobilních API endpointů TikToku (nižší detekce) | Těžká | Zdarma | Vysoká |
| Rotace residential proxy | Střední | 20–100 $/měsíc | Vysoká |
Bezplatné techniky, které skutečně pomáhají
Náhodné prodlevy mezi requesty. Nespouštějte requesty v těsné smyčce. Mezi requesty přidejte náhodný jitter 2–8 sekund. To je to nejjednodušší, co můžete udělat:
import time, random
time.sleep(random.uniform(2, 8))
Znovupoužití session a cookies. Nevytvářejte novou session pro každý request. Znovu používejte cookies a session state napříč dávkou requestů a pak je rotujte. Přesně proto moderní repozitáře chtějí ms_token místo slibů o stateless scrapingu.
Scrapujte veřejné stránky bez přihlášení. TikTok-Api výslovně uvádí, že nepodporuje routes vyžadující autentizaci uživatele a funguje jen na datech viditelných po odhlášení. Scraping bez přihlášení má nižší detekční profil než autentizované session.
Respektujte robots.txt. Aktuální robots.txt TikToku blokuje mnoho agentů úplně a pro obecný crawling povoluje jen omezenou sadu veřejných cest. Není to zelená pro agresivní scraping, ale respektování tohoto souboru snižuje riziko okamžitého blacklistu IP.
Středně pokročilé techniky pro vyšší úspěšnost
Náhodný browser fingerprint u headless režimu. Pokud používáte Playwright, randomizujte u každé session velikost viewportu, user-agent, timezone a locale. Scraper pak působí jako pokaždé jiný skutečný uživatel, ne jako stejný bot s novou IP.
Použití mobilních API endpointů TikToku. Někteří členové komunity hlásí nižší míru detekce, když cílí na mobilní endpointy místo webového frontendu. Je to složitější na implementaci a méně zdokumentované, ale pro pokročilé uživatele jde o reálnou techniku.
Kdy už proxy potřebujete (a co je relativně dostupné)
Ve velkém měřítku zdarma techniky nestačí. Rotace residential proxy je standardní přístup pro objemný TikTok scraping. Nebudu zde doporučovat konkrétní placenou proxy službu, ale obecná rada zní: vyhněte se datacenter proxy (TikTok je agresivně označuje) a hledejte residential nebo mobile proxy pool s rotací na úrovni každého requestu.
Případně browserové nástroje jako Thunderbit obcházejí otázku proxy úplně, protože běží ve vaší vlastní browser session a napodobují skutečného uživatele. To z nich nedělá neviditelné řešení ve velkém měřítku, ale pro typické marketingové nebo výzkumné use casy (desítky až stovky stránek, ne miliony) je to mnohem jednodušší cesta.
Jaká data vlastně dostanete? Reálné ukázky výstupů z TikTok scraperů
Uživatelé chtějí předem vědět, jaká data skutečně získají, než se zavážou k nástroji — a většina průvodců to úplně vynechává. Tady jsou reprezentativní struktury polí vycházející ze zdrojové dokumentace.
Data profilu
| Username | Zobrazené jméno | Sledující | Sleduje | Celkem lajků | Bio | Ověřeno | URL profilu |
|---|---|---|---|---|---|---|---|
| @examplecreator | Jane Doe | 1 240 000 | 312 | 48 700 000 | "Cooking + comedy 🍳" | ✅ | tiktok.com/@examplecreator |
| @travelwithmark | Mark S. | 890 000 | 150 | 22 100 000 | "Travel vlogger 🌍" | ❌ | tiktok.com/@travelwithmark |
| @fitnessmaya | Maya L. | 2 100 000 | 88 | 91 300 000 | "Workouts & wellness" | ✅ | tiktok.com/@fitnessmaya |
Dostupné z: GitHub scraperů (TikTok-Api, Evil0ctal), Research API, Thunderbit (z viditelných profilových stránek).
Metadata videa
| URL videa | Popisek | Zhlédnutí | Lajky | Komentáře | Sdílení | Hudba | Hashtagy | Datum zveřejnění | Délka |
|---|---|---|---|---|---|---|---|---|---|
| tiktok.com/@ex/video/123 | "Best pasta trick ever 🍝" | 4 200 000 | 312 000 | 8 400 | 21 000 | "Italian Vibes – DJ Marco" | #pasta #cooking #hack | 2026-03-15 | 0:42 |
| tiktok.com/@ex/video/456 | "POV: your cat judges you" | 9 100 000 | 1 100 000 | 23 000 | 55 000 | "Original Sound" | #cat #pov #funny | 2026-04-01 | 0:18 |
| tiktok.com/@ex/video/789 | "Morning routine nobody asked for" | 1 800 000 | 98 000 | 3 200 | 7 500 | "Chill Morning – LoFi" | #routine #morning | 2026-04-10 | 1:02 |
Dostupné z: GitHub scraperů (TikTok-Api, Evil0ctal), Research API (pole zahrnují video_description, view_count, like_count, comment_count, share_count, music_id, hashtag_names, video_duration), Thunderbit (pole na úrovni videa).
Data komentářů
| Autor komentáře | Text komentáře | Lajky | Časová značka | Odpovědi |
|---|---|---|---|---|
| @user_abc | "I tried this and it actually works 😂" | 1 200 | 2026-03-16T08:12:00Z | 14 |
| @chef_dan | "Add garlic next time, trust me" | 890 | 2026-03-16T09:45:00Z | 7 |
| @randomfan99 | "This is the content I'm here for" | 340 | 2026-03-16T11:30:00Z | 2 |
Dostupné z: GitHub scraperů (TikTok-Api, Evil0ctal), Research API (pole zahrnují text, like_count, reply_count, create_time), Thunderbit (z viditelných sekcí komentářů).
Hashtag a search data
| Hashtag | Top URL videa | Celkové zhlédnutí | Trendy |
|---|---|---|---|
| #pasta | tiktok.com/@ex/video/123 | 4 200 000 | Ano |
| #cooking | tiktok.com/@chef/video/321 | 11 000 000 | Ano |
| #hack | tiktok.com/@tips/video/654 | 2 900 000 | Ne |
Dostupné z: GitHub scraperů (liší se podle repozitáře), Thunderbit (šablona hashtag scraperu).
Poznámka: Žádný jediný repozitář negarantuje všechna pole vždy. Struktury odpovědí TikToku se mění a sami maintainers na to upozorňují. Berte to jako reprezentativní příklady, ne jako záruku.
Jak vytěžit data z TikToku ve 2 kliknutích s Thunderbit (krok za krokem)
Už vás nebaví cyklus „rozbije se — opraví se“? Tady je no-code cesta — únik pro každého, kdo to z GitHub repozitáři zkoušel a neuspěl.
- Nainstalujte Thunderbit Chrome Extension.
- Otevřete TikTok stránku, kterou chcete scrapovat — profil, stránku s výsledky hledání, hashtag stránku nebo konkrétní video.
- Klikněte na „AI Suggest Fields“. AI v Thunderbit přečte stránku a navrhne sloupce: username, followers, video caption, likes, hashtags atd.
- Upravte pole podle potřeby a klikněte na „Scrape“. Data se naplní do strukturované tabulky.
- Použijte Subpage Scraping pro obohacení dat. Klikněte na každé video v seznamu profilu a stáhněte další pole: plný popisek, detaily hudby, počet komentářů, počet sdílení.
- Exportujte do Google Sheets, Excelu, Airtable nebo Notion — úplně zdarma.
Žádná údržba, žádné řešení instalace, žádná anti-ban konfigurace. AI se automaticky přizpůsobuje změnám rozložení TikToku.
Obohacení TikTok dat pomocí Subpage Scraping
Po vyextrahování seznamu videí z profilu nebo hashtag stránky klikněte na „Scrape Subpages“ a AI navštíví každou stránku videa, odkud stáhne další pole. To je obzvlášť užitečné pro marketéry budující databáze influencerů nebo dělající audit obsahu konkurence — získáte kompletní tabulku engagement dat na úrovni videí bez ručního klikaní desítek stránek.
Export a využití TikTok dat
Thunderbit exportuje do Google Sheets, Excelu, Airtable, Notion, CSV nebo JSON — zdarma. Běžné use casy:
- Přeneste data do tabulky pro analýzu engagementu.
- Pošlete je do Airtable jako CRM-style tracker influencerů.
- Nahrajte je do Notion pro týmovou spolupráci na content research.
Pro hlubší pohled na to, jak Thunderbit pracuje s extrakcí webových dat, si přečtěte náš průvodce pro začátečníky web scrapingem nebo se podívejte na návody na YouTube kanálu Thunderbit.
Zůstaňte v mezích zákona: TikTok Terms of Service a soulad scrapingu s pravidly
Právní postoj TikToku je jasný. Privacy blog o scrapingu uvádí, že podmínky služby zakazují automatizované skripty, které shromažďují informace nebo se službou interagují nepovoleným způsobem, a výslovně zmiňuje obcházení přístupových omezení. Community Guidelines také zakazují klamavé pokusy o získávání informací pomocí automatizovaných skriptů nebo web crawlingu.
Praktické doporučení:
- Držte se veřejně dostupných dat. Nescrapujte soukromý obsah ani obsah za přihlášením.
- Respektujte rate limity. Nezatěžujte servery TikToku.
- Dodržujte zákony o ochraně osobních údajů. Pokud sbíráte, ukládáte nebo analyzujete osobní data, platí GDPR a CCPA.
- Použijte Research API, pokud na něj dosáhnete. Z hlediska compliance je to nejbezpečnější cesta.
- Toto není právní rada. Pro konkrétní situaci se poraďte s odborníkem.
Více o právním rámci najdete v našem průvodci právními dopady web scrapingu.
Co dělat, když váš TikTok scraper repozitář z GitHubu zemře
Krátká verze:
- Vždy spusťte 60sekundový checklist životaschopnosti repozitáře před tím, než jakýkoli TikTok scraper z GitHubu naklonujete. Většina repozitářů je už mrtvá.
- Pochopte své možnosti. Oficiální API, GitHub scrapery a no-code nástroje slouží různým uživatelům a use casům.
- Pokud zvolíte GitHub cestu, vyhraďte si čas na troubleshooting instalace a anti-ban konfiguraci. Počítejte s průběžnou údržbou.
- Zjišťujte, jaká data opravdu dostanete ještě předtím, než se na nástroj navážete. Neřešte jen počet hvězdiček, ale konkrétní výstupní pole.
- Pokud nejste vývojář (nebo už vás unavují rozbité repozitáře), zkuste no-code nástroj jako Thunderbit — dvě kliknutí, strukturovaná data, export zdarma.
TikTok data, která potřebujete, jsou dostupná. Otázka je, jestli chcete čas trávit údržbou scraperu, nebo raději prací s daty. Zvolte přístup, který odpovídá vaší úrovni a use casu, a nenechte další odpoledne zmizet kvůli mrtvému GitHub repozitáři.
Vyzkoušet Thunderbit pro TikTok data
FAQ
Existují na GitHubu nějaké TikTok scrapery, které v roce 2026 stále fungují?
Ano, ale seznam je krátký. davidteather/TikTok-Api je k dubnu 2026 nejvěrohodnější open-source volba s aktivní údržbou. Evil0ctal/Douyin_TikTok_Download_API je také stále živý, ale složitější. Repozitář s nejvíc hvězdičkami, drawrowfly/tiktok-scraper, nebyl aktualizován od května 2023 a je prakticky mrtvý. Před investováním času do jakéhokoli repozitáře vždy spusťte checklist životaschopnosti.
Je legální scrapovat TikTok?
Podmínky služby TikToku automatizovaný scraping výslovně zakazují. Veřejně viditelná data se právně pohybují v šedé zóně, která se liší podle jurisdikce. Nejbezpečnější cesta je oficiální Research API pro oprávněné výzkumníky. Pokud scrapujete veřejná data, držte se veřejně přístupného obsahu, respektujte rate limity a dodržujte GDPR/CCPA. Toto není právní rada — pro svůj případ se poraďte s odborníkem.
Můžu scrapovat TikTok bez programování?
Ano. Browserové AI nástroje jako Thunderbit vám umožní získat strukturovaná TikTok data (profily, metadata videí, hashtagy, engagement metriky) bez jediného řádku kódu. TikTok Research API také vyžaduje jen minimální programování pro schválené žadatele. Pro neprogramátory jsou no-code nástroje nejrychlejší a nejspolehlivější cesta.
Jaká data mohu z TikTok scraperu získat?
Mezi běžné typy dat patří profilové informace (username, followers, bio, verified status), metadata videí (popisek, zhlédnutí, lajky, komentáře, sdílení, hudba, hashtagy, délka, datum zveřejnění), komentáře (text, lajky, časová značka, odpovědi) a data hashtagů/hledání (top videa, celkové zhlédnutí, stav trendu). Přesná pole závisí na nástroji a metodě — podívejte se na sekci s ukázkami výstupů výše.
Proč se můj TikTok scraper pořád blokuje?
TikTok používá více vrstev anti-bot ochrany: rate limiting, cookie/session gating, browser fingerprinting, behaviorální detekci, šifrované parametry requestů a CAPTCHA flow. Časté příčiny blokace jsou příliš rychlé requesty, vytvoření čisté/nové session pro každý request, spuštění headless browseru s výchozími fingerprinty nebo použití datacenter proxy. V sekci o nejlepších praktikách proti banům výše najdete zdarma i placené workaroundy.
