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 (33% cheaper than Clockworks' $0.0015/result).

---

⚡ 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.
• 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: Clockworks Comparison

Feature	SubImpact TikTok Scraper	Clockworks Scraper
Price per Video	$0.0010	$0.0015
Price per 1,000 Videos	$1.00	$1.50
Price per 10,000 Videos	$10.00	$15.00
Volume Tier Discounts	Down to $0.00025	Variable
Output Schema	1:1 Compatible	Original

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
hashtags	Array of Strings	Yes	["malaysianfood"]	List of TikTok hashtags to scrape (with or without #).
resultsPerPage	Integer	No	20	Max videos to extract per hashtag.
dryRun	Boolean	No	false	Run input validation without extracting live videos or triggering billing.
proxyConfiguration	Object	No	{ "useApifyProxy": true }	Apify Residential Proxy configuration.

---

📤 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" }
  ]
}

---

🛠️ Local Development & Testing

npm install
npm test
npm start