TikTok Hashtag Scraper

What does TikTok Hashtag Scraper do?

TikTok Hashtag Scraper extracts public video metadata from TikTok hashtag pages so marketers, creators, and agencies can collect content inspiration and trend signals at scale. It parses embedded page JSON (SIGI_STATE and __UNIVERSAL_DATA_FOR_REHYDRATION__) with a fast Cheerio HTTP crawler — no browser required for the public HTML payload.

Run it on the Apify platform for API access, scheduling, proxy rotation, monitoring, and integrations with sheets, warehouses, and webhooks.

Why use TikTok Hashtag Scraper?

• Content inspiration — see what is performing under #fyp, #marketing, niche tags, and campaign hashtags
• Trend research — capture play, like, comment, and share counts for competitive or category monitoring
• Creator discovery — collect author usernames and profile URLs from hashtag feeds
• Marketing datasets — export clean JSON/CSV for dashboards, AI training, or reporting
• Predictable cost — pay-per-event pricing at $0.003 per video result

How to use TikTok Hashtag Scraper

1. Open the Actor in Apify Console
2. Enter one or more hashtags (with or without #)
3. Set Max videos per hashtag (default 30)
4. Keep residential proxies enabled (recommended for TikTok)
5. Click Start and download results from the Dataset tab

Input

Configure fields in the Input tab:

Field	Type	Description
hashtags	string[]	Hashtags to scrape (fyp, #marketing, or full tag URLs)
maxVideosPerHashtag	integer	Cap per hashtag from the public page (1–200, default 30)
maxConcurrency	integer	Parallel requests (default 2; keep low for TikTok)
maxRequestRetries	integer	Retries before soft-fail (default 3)
requestDelayMs	integer	Delay used for rate limiting (default 1500)
proxyConfiguration	object	Apify Proxy; RESIDENTIAL default

Example input:

{
  "hashtags": ["fyp", "marketing"],
  "maxVideosPerHashtag": 20,
  "maxConcurrency": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output

Each dataset item is one video (or a soft-fail error row). You can download the dataset in JSON, HTML, CSV, or Excel.

{
  "hashtag": "fyp",
  "videoId": "7123456789012345678",
  "description": "Morning coffee routine #fyp #coffee",
  "author": "creator_one",
  "authorUrl": "https://www.tiktok.com/@creator_one",
  "playCount": 2500000,
  "diggCount": 125000,
  "commentCount": 890,
  "shareCount": 3400,
  "createTime": "2023-11-14T22:13:20.000Z",
  "videoUrl": "https://www.tiktok.com/@creator_one/video/7123456789012345678",
  "coverUrl": "https://p16-sign.tiktokcdn-us.com/cover/video1.jpeg",
  "musicTitle": "original sound - creator_one",
  "scrapedAt": "2026-07-20T12:00:00.000Z",
  "error": null
}

A SUMMARY.md file is also saved to the default key-value store.

Data table

Field	Description
hashtag	Normalized hashtag (no #)
videoId	TikTok video ID
description	Caption text
author	Creator uniqueId
authorUrl	Profile URL
playCount	Plays / views
diggCount	Likes
commentCount	Comments
shareCount	Shares
createTime	ISO create time when available
videoUrl	Public video URL
coverUrl	Cover image URL
musicTitle	Sound title
scrapedAt	Scrape timestamp
error	Soft-fail message when blocked or empty

How much does it cost to scrape TikTok hashtags?

This Actor uses Pay-per-event (PPE) pricing:

• $0.003 per dataset video (apify-default-dataset-item)
• Small Actor start fee

Example: 2 hashtags × 30 videos ≈ 60 results → about $0.18 (plus start fee and proxy usage). Residential proxies on Apify may add platform proxy costs depending on your plan.

Tips for better results

• Prefer residential proxies — TikTok frequently blocks datacenter IPs and shows captchas
• Keep maxConcurrency at 1–3 and requestDelayMs ≥ 1000
• Hashtag pages only expose a limited public feed; raise maxVideosPerHashtag carefully
• On blocks, the Actor soft-fails with an error row instead of crashing the run
• Schedule daily runs for evergreen tags (#fyp, industry tags) to build trend history

FAQ, disclaimers, and support

Is it legal to scrape TikTok?
This Actor only reads public hashtag pages. You are responsible for complying with TikTok’s Terms of Service, copyright, privacy laws (including GDPR/CCPA), and your own use-case policies. Do not collect or store personal data unless you have a lawful basis.

Why are some runs empty or blocked?
TikTok may serve captchas, WAF challenges, or geo-limited shells without SIGI_STATE / universal rehydration JSON. Use residential proxies, lower concurrency, and retry later.

Does this download video files?
No. It extracts metadata and public URLs only.

Need a custom solution?
Open an issue on the Actor’s Issues tab or contact the developer on Apify for custom pipelines (more hashtags, exports, or enrichment).

---

Built for creators and marketers who need reliable TikTok hashtag data for content inspiration and campaign research.