Tiktok Scraper

TikTok Scraper for Influencer Research & Viral Trend Analysis (Videos, Profiles, Hashtags)

Extract high-value TikTok data to identify viral trends, analyze competitors, and build influencer lists—all from one scraper. This actor is built for marketers, agencies, and researchers who want structured, scalable data without manual scrolling.

What this TikTok Scraper actually helps you do

Most tools just dump raw pages. This actor is designed to produce a dataset you can use for decisions:

• Find viral content early using engagement signals
• Build influencer shortlists from author metadata (best-effort)
• Compare what’s working across hashtags, profiles, and search topics
• Create repeatable research runs (same seeds, new data snapshots)

Key benefits (why use this actor)

• Save hours of manual research and copy-paste
• Collect consistent engagement metrics (views/likes/comments/shares where available)
• Scale across many seeds using controlled limits
• Export to JSON/CSV/Excel on Apify, then automate workflows via the API
• Proxy + optional session support for stability on TikTok web

Core features

• Scrape by hashtags, keywords, profiles, or URLs
• Discovery + detail extraction: collects video links from listing pages, then opens each video to extract metadata
• Engagement metrics: likes (diggCount), plays (playCount), comments (commentCount), shares (shareCount), saves (collectCount) when present
• Profile/author metadata (authorMeta) as available in TikTok’s embedded/XHR JSON
• Video + music metadata (videoMeta, musicMeta)
• Source tracking: sourceType / sourceValue so you know which seed produced each video
• Proxy support: Apify Proxy (residential recommended) + disableProxy for local debugging
• Optional session: provide cookies or full Playwright storageState to reduce login/captcha pages (treat as secrets)

What data you can extract (output)

Each dataset item is one video (see .actor/dataset_schema.json). Typical fields:

• webVideoUrl, id
• text (caption) and textLanguage (when detected)
• createTime (unix) + createTimeISO
• authorMeta (object; best-effort, TikTok-dependent)
• playCount, diggCount, commentCount, shareCount, collectCount
• musicMeta, videoMeta
• isAd (when detectable)
• sourceType, sourceValue
• timestamp (scrape time), plus error / extractionNotes on partial failures

Important: TikTok changes frequently. Some fields can be missing depending on region, session state, or anti-bot responses. The actor records error / extractionNotes when it can only extract partial metadata.

Customizable scraping options (input)

Full schema: INPUT_SCHEMA.json.

Seed types you can use

• hashtags: hashtag strings (without #)
• profiles: usernames (with/without @) or profile URLs
• searchQueries: keyword queries for TikTok web search
• startUrls / urls: direct TikTok URLs (video/profile/tag/search)
• videoUrls: direct video URLs only (skips discovery)

Limits and scale controls

• resultsPerPage: max video links collected per seed
• scrollRoundsPerSeed: how much to scroll on tag/profile/search pages for discovery
• maxItems: cap on unique videos to open and extract (after discovery)

Proxy + session options

• proxyConfiguration: use Apify Proxy (residential recommended on Apify Cloud)
• disableProxy: turn off proxy (local debugging)
• cookies or storageState: optional login/session export (best-effort; sessions expire)

How to use on Apify

1. Deploy tiktok-scraper/ as an Apify actor (Git integration or upload).
2. Use the provided Dockerfile.
3. In Apify Console, enable Apify Proxy (residential recommended) and set your input.
4. Run → open Dataset → export JSON/CSV/Excel or use the API.

Example input

{
  "hashtags": ["marketing", "ugc"],
  "profiles": ["tiktok"],
  "searchQueries": ["influencer marketing"],
  "resultsPerPage": 30,
  "maxItems": 100,
  "scrollRoundsPerSeed": 12,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Local run

cd tiktok-scraper
pip install -r requirements.txt
playwright install chromium
python main.py

Real use cases

• Influencer marketing: find creators by engagement signals and build outreach lists (using authorMeta + video URLs).
• Trend discovery: monitor hashtags/search topics and surface high-performing videos early.
• Competitor analysis: compare what competitors post and what performs (profiles + counts).
• Content strategy: build data-backed content plans instead of guessing.

FAQ

What kind of TikTok data can I extract?

Video metadata (caption, URL, time), engagement counts (views/likes/comments/shares/saves when available), and author/music/video metadata objects when TikTok exposes them.

Can I scrape TikTok using hashtags or keywords?

Yes—use hashtags and/or searchQueries, plus limits like resultsPerPage and maxItems.

Is this useful for influencer marketing?

Yes—use profile seeds or hashtag seeds, then filter by engagement and the authorMeta object (best-effort).

Can I track trending content?

Yes—run repeat scrapes on the same seeds and analyze changes in counts over time.

Does it support large-scale scraping?

Yes, but TikTok is anti-bot heavy—use residential proxy and keep limits reasonable.

What formats are available for export?

Apify dataset export supports JSON, CSV, and Excel.

Do I need coding skills?

No—configure input in Apify Console and export results.

How accurate is the data?

It’s pulled from TikTok web payloads at run time, but TikTok can block/alter responses; use proxy/session settings and expect occasional partial items (see error / extractionNotes).

SEO keywords (high-intent)

tiktok scraper, tiktok influencer scraper, tiktok hashtag scraper, tiktok video scraper, tiktok trend analysis, tiktok competitor analysis, tiktok data scraper, tiktok scraping api, influencer research scraper

Actor permissions

Designed for limited permissions: reads input and writes to the default dataset.

Limitations

• TikTok anti-bot is aggressive; residential proxy is strongly recommended on Apify.
• Optional cookies / storageState can help but sessions expire and may fail under mismatched IP/proxy.
• This actor extracts public web metadata; it’s not guaranteed to return full profile stats for every seed.
• TikTok DOM/API shapes change; some fields can go missing until selectors/paths are updated.
• Follow TikTok ToS and applicable privacy/marketing laws.

License

MIT.

Get started

Start with 1–2 seeds and a small maxItems, verify results, then scale with proxy enabled.