TikTok Hashtag Scraper 🚀

A high-performance, native TikTok hashtag scraper engineered for reliability, deep data fidelity, and ultra-competitive pricing.

1:1 Drop-in Replacement for clockworks/tiktok-hashtag-scraper at $0.0010/result, below Clockworks' $0.0030 Free-plan list price.

---

⚡ Features & Advantages

• Zero Upstream Dependencies: Powered by native browser extraction with advanced anti-bot evasion. No proxy re-delegation or hidden fees.
• Full Clockworks Schema Compatibility: Drop-in replacement for existing workflows, pipelines, and integrations.
• Pay-Per-Event Monetization: Only pay for the videos you actually scrape (results are delivered and charged incrementally, in small batches, as the crawl finds them).
• URLs, not files: the actor delivers CDN/web URLs for videos and covers; it does not download the media files themselves.
• Rich Data Extraction:
  • Video metadata (ID, caption, duration, resolution, direct download/play URLs, covers)
  • Creator insights (uniqueId, nickname, avatar, follower counts, total likes, video count, verified status)
  • Engagement metrics (play count, likes, comments, shares, saves)
  • Music & sound details (track ID, audio title, author, original sound flag, audio duration)
  • Extracted hashtags & challenges

---

💰 Pricing

$0.0010 per delivered result ($1.00 per 1,000 videos), plus a $0.00005 actor-start event. You are charged only for videos that reach the dataset, in small batches as the crawl finds them.

How this compares

Results are pushed and charged incrementally, so a stopped or timed-out run bills only what it collected, and rows carry CDN URLs for videos and covers instead of downloaded files. At $1.00 per 1,000 results it is below clockworks/tiktok-hashtag-scraper ($3.00), parseforge/tiktok-hashtag-analytics-scraper ($6.55) and webdata_labs/tiktok-hashtag-trends-scraper ($2.00). memo23/tiktok-hashtag-scraper lists $0.49 per 1,000 dataset items, plus $0.002 per video download.

Actor	Price per 1,000 results	Platform usage
subimpact/tiktok-hashtag-scraper	$1.00	not billed separately
clockworks/tiktok-hashtag-scraper	$3.00	see listing
parseforge/tiktok-hashtag-analytics-scraper	$6.55	see listing
webdata_labs/tiktok-hashtag-trends-scraper	$2.00	see listing
memo23/tiktok-hashtag-scraper	$0.49	see listing

Prices are Apify Store list prices on the Free plan, checked 24 October 2026. Competitor prices can change; check their listings.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
hashtags	Array of Strings	No	["malaysianfood"]	List of TikTok hashtags to scrape (with or without #). When omitted or empty, the default hashtag is used, so {} is a valid input. Maximum 25 hashtags per run; the rest are ignored with a warning.
resultsPerPage	Integer	No	20	Max videos to extract per hashtag (clamped to 1–500).
dryRun	Boolean	No	false	Run input validation without extracting live videos or triggering billing.
proxyConfiguration	Object	No	{ "useApifyProxy": true }	Apify Proxy configuration. The default Apify datacenter proxy group is often blocked by TikTok with the "Something went wrong" anti-bot page. If a run ends with 0 results, the actor sets a clear status message asking you to re-run with the RESIDENTIAL proxy group, e.g. { "useApifyProxy": true, "groups": ["RESIDENTIAL"] }.

Note: media file downloading (videos/covers/subtitles) is not supported. The actor returns direct CDN and web URLs only.

---

📤 Output Dataset Format

Every video pushed to the default dataset follows the standard schema:

{
  "id": "7617067749516283159",
  "text": "Nasi lemak! My favourite Malaysian meal, always... #malaysianfood #recipe",
  "createTime": 1773486793,
  "createTimeISO": "2026-03-14T11:13:13.000Z",
  "webVideoUrl": "https://www.tiktok.com/@xiensscran/video/7617067749516283159",
  "videoUrl": "https://v16-webapp-prime.us.tiktok.com/video/...",
  "diggCount": 13400,
  "playCount": 190500,
  "commentCount": 67,
  "shareCount": 830,
  "collectCount": 2775,
  "authorMeta": {
    "id": "7066039379093128197",
    "name": "xiensscran",
    "nickName": "Xien",
    "verified": false,
    "avatar": "https://p16-va.tiktokcdn.com/...",
    "fans": 164200,
    "following": 408,
    "heart": 3100000,
    "video": 186
  },
  "musicMeta": {
    "musicId": "7617067762355112726",
    "musicName": "original sound",
    "musicAuthor": "Xien",
    "musicOriginal": true
  },
  "hashtags": [
    { "name": "malaysianfood", "title": "malaysianfood" },
    { "name": "recipe", "title": "recipe" }
  ]
}

Output field notes

Every field in the sample above (and all other delivered fields) is declared in .actor/dataset_schema.json. If a hashtag in a multi-hashtag run delivers 0 videos, the dataset contains one uncharged status row with an error field explaining why — downstream pipelines can distinguish empty tags from real failures.

---

🛠️ Local Development & Testing

npm install
npm test
npm start