TikTok Hashtag Videos Scraper

Scrape TikTok videos under any hashtag — search by keyword (the Actor auto-resolves the matching hashtag) or pass an exact hashtag ID. Returns clean, structured data for each video: description, like / comment / play / share counts, author, music, hashtags, share URL, and the direct video play address.

Unofficial. This Actor is not affiliated with, authorized, or endorsed by TikTok or ByteDance. It is an independent tool that retrieves publicly available data via a third-party API. Use it in compliance with TikTok's terms and all applicable laws; you are responsible for how you use the retrieved data.

What it does

• Keyword mode — give one or more hashtag keywords (e.g. fitness). For each, the Actor resolves the most-used matching hashtag, then pages through its videos.
• Hashtag ID mode — give exact numeric hashtag IDs (cid, e.g. 9261 for #Fitness) to skip resolution and pull videos directly.
• Paginates each hashtag with cursor + has_more, de-dupes by video ID, and stops at maxItems.

Input

Field	Type	Default	Description
searchKeywords	string[]	["fitness"]	Hashtag keywords (no #). The top matching hashtag is resolved for each.
hashtagIds	string[]	[]	Exact hashtag IDs (cid). Skips keyword resolution.
maxItems	integer	50	Max total videos across all hashtags.

Example input

{
  "searchKeywords": ["fitness", "cooking"],
  "hashtagIds": ["9261"],
  "maxItems": 200
}

Output

One dataset item per video:

{
  "awemeId": "7230230926578650414",
  "url": "https://www.tiktok.com/@jeremythehulk/video/7230230926578650414",
  "description": "better arms for summer!!! #Fitness #fitspo #workout #gym",
  "createTime": 1683419331,
  "diggCount": 1125266,
  "commentCount": 1922,
  "playCount": 7929557,
  "shareCount": 15116,
  "collectCount": 0,
  "authorUniqueId": "jeremythehulk",
  "authorNickname": "Fitness With Jeremy",
  "authorId": "6650267573202649094",
  "musicTitle": "CAUTION",
  "musicAuthor": "Dxrk ダーク",
  "videoDuration": 60602,
  "coverUrl": "https://...",
  "playAddr": "https://...",
  "hashtags": ["Fitness", "fitspo", "workout", "gym"],
  "shareUrl": "https://www.tiktok.com/@jeremythehulk/video/7230230926578650414?...",
  "source": "keyword:fitness"
}

Notes

• Data is sourced live; TikTok occasionally rate-limits, so the Actor retries transient blocks with exponential backoff.
• Video IDs are de-duplicated within a run.
• videoDuration is in milliseconds. CDN URLs (coverUrl, playAddr) are signed and expire.

Quick start

1. Open the Actor and press Run — the default input works out of the box.
2. Adjust the input fields below to your target (keywords, IDs, or URLs) and set maxItems to cap spend.
3. Grab results from the Dataset tab as JSON / CSV / Excel, or pull them via the Apify API and MCP from your own code.

No proxies to configure, no cookies to paste, no login — the Actor handles everything server-side.

Why teams switch to this TikTok hashtag scraper

Hashtag feeds map a TikTok topic fast, but browser scrapers choke on them. This Actor uses a direct HTTP API to return videos under any hashtag — author, caption, music, and engagement — as clean JSON at $1 per 1,000 videos — roughly 40% below the big-name TikTok scrapers.

What people build with it

• Challenge & trend tracking — follow a hashtag daily to measure momentum and capture the top entries.
• Campaign measurement — monitor your branded hashtag for reach and UGC across creators.
• Creator discovery — accounts that repeatedly top a niche tag are your collaboration shortlist.
• Competitive analysis — see which tags competitors push and which videos win under them.
• Content research — high-performing videos under a tag are a template library for your own posts.

Tips for better results

• Pass tags with or without the leading #.
• Discover videos here, then transcribe the winners with TikTok Transcript Scraper.
• Profile standout creators with TikTok Profile Scraper.

---

Why this Actor

• Direct API, no headless browser — fast, stable runs with nothing to babysit.
• No login, no cookies — we never touch your accounts, so there's no ban risk.
• Fresh, real-time data — every run reads the source live, not a stale cache.
• Pay per result — you're billed only for the rows actually delivered.
• Structured JSON — export to CSV, Excel, or JSON, or pull straight from the API / MCP.

Use cases

• Track trends, keywords, and hashtags as they emerge.
• Find top creators and viral content in any niche.
• Run competitor and category research at scale.
• Build content-idea pipelines and trend dashboards.

FAQ

Do I need an account, cookies, or to log in anywhere? No. The Actor talks to a fast, direct HTTP API server-side — you just provide inputs and run it.

How am I billed? Pay-per-result: a fixed price per row returned, with no separate platform/compute charge. Caps like maxItems keep spend predictable.

Can I run it on a schedule or call it from my app? Yes — use Apify Schedules, the REST API, the JavaScript / Python clients, or the MCP server. See the API tab.

Is this affiliated with TikTok? No. It's an independent tool that collects publicly available data. Use it in line with the platform's terms and applicable law.

What inputs are accepted? Profile handles/URLs, video URLs, hashtags, or keywords, depending on the Actor — see the Input section above.

More TikTok scrapers by us

• TikTok Shop Products — Product search · price · sales · shop data
• TikTok Video Search — Keyword video search · 60+ fields · MP4
• TikTok User Posts — Creator post feed · stats · MP4 download
• TikTok Profile — Profile stats · bio · follower counts
• TikTok Comments — Video comments + nested replies

Browse the full fleet → https://apify.com/ethereal_wool