TikTok Hashtag Scraper

Export public TikTok hashtag videos, captions, creators, engagement metrics, music, covers, and video URLs.

Use this Actor to turn TikTok hashtag pages into clean datasets for campaign tracking, social listening, creator discovery, content research, trend monitoring, and marketing analysis. Results can be downloaded as CSV, JSON, Excel, XML, RSS, or used through the Apify Dataset API.

At a glance

• Hashtag video export: Enter hashtags such as booktok, skincare, or #fitness and save public videos from each tag page.
• Creator and caption data: Collect creator usernames, display names, profile URLs, captions, music titles, video URLs, and cover images.
• Engagement metrics: Export public play, like, comment, and share counts when TikTok exposes them.
• Resilient partial runs: Completed rows are saved progressively. RUN_SUMMARY explains a partial run and PENDING_HASHTAGS can be passed back with resumeHashtags.
• Campaign research: Compare hashtags, creators, caption patterns, and engagement signals across a topic or campaign.
• API export: Send hashtag video rows to spreadsheets, dashboards, creator CRMs, BI tools, or AI agents.

Ready-to-run examples

Use these saved Store examples as starting points. Open any example to prefill the Actor input, then adjust URLs, keywords, limits, or filters for your own run.

• Tiktok Hashtag Public Engagement Snapshot
• Tiktok Hashtag Video Caption Dataset
• Tiktok Hashtag Education Content
• Tiktok Hashtag Local Tourism Videos
• Tiktok Hashtag Event Campaign Monitor
• Tiktok Hashtag Seasonal Trend Monitor
• View all ready-to-run examples (25 examples)

What can it do?

TikTok Hashtag Scraper collects public videos from TikTok hashtag pages and saves one dataset row per video.

• Scrape multiple hashtags: Run one hashtag or compare several related hashtags in one run.
• Normalize hashtag input: Use values with or without #, or paste supported TikTok tag URLs.
• Collect creator context: Save usernames, display names, profile URLs, captions, music, and video URLs.
• Track engagement: Capture public play, like, comment, and share counts when available.
• Export repeatable datasets: Use Apify downloads, API calls, schedules, webhooks, and integrations.

Common workflows

• Campaign reporting: Export public videos for branded hashtags and compare engagement over time.
• Creator discovery: Find creators posting under niche hashtags and review their public profile links.
• Social listening: Monitor public content around products, topics, events, or communities.
• Content research: Analyze caption language, music choices, covers, and top-performing video examples.
• Trend monitoring: Schedule recurring hashtag runs for daily or weekly snapshots.
• Market research: Compare competing category hashtags across creators and engagement signals.

What data can you extract?

The Actor returns one dataset row per public TikTok hashtag video.

Field	Description
hashtag	Source hashtag
videoId	TikTok video ID
videoUrl	Public video URL
caption	Video caption text
authorUsername	Creator username
authorProfileUrl	Creator profile URL
authorDisplayName	Creator display name
createTime	Published timestamp when available
duration	Video duration in seconds
playCount	View or play count
diggCount	Like count
commentCount	Comment count
shareCount	Share count
coverUrl	Cover image URL
musicTitle	Music or sound title
musicId	TikTok music identifier when exposed
authorId / verified	Public creator identifier and verification flag when exposed
collectCount	Public save/favorite count when exposed
scrapedAt	Time the row was collected

Pricing

This Actor uses Apify pay-per-event pricing. The prices below come from the current Actor pricing configuration. Apify public plans map to Store discount tiers, so the table shows both the user-facing plan context and the pricing tier name. The final price shown in Apify depends on the user account plan and any custom agreement.

Event	What is charged	Price
start	One-time fee charged when a run starts. Covers fixed startup cost (browser launch, proxy warmup, and initial page setup).	$0.01

Event	What is charged	Free / no discount	Starter / Bronze	Scale / Silver	Business / Gold	Custom / Platinum	Custom / Diamond
result	Charged per public TikTok hashtag video saved to the dataset.	$11.6 / 1,000	$10.09 / 1,000	$7.8694 / 1,000	$6.0534 / 1,000	$4.0356 / 1,000	$2.8249 / 1,000

Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account.

Input configuration

Setting	JSON key	Use it for	Example
TikTok hashtags	hashtags	Required list of hashtags to scrape, with or without #.	["booktok", "skincare"]
Maximum videos per hashtag	maxItemsPerHashtag	Cap saved rows per hashtag and control spend.	20
Sort mode	sortMode	TikTok public hashtag feed mode. Current supported value is top.	top
Include video technical details	includeVideoDetails	Add optional width, height, and bitrate fields when TikTok returns them.	false
Maximum run time	maxRunSeconds	Save completed work and checkpoint remaining hashtags before the platform timeout.	540
Pagination delay	minDelayMs, maxDelayMs	Set a randomized polite pause between page actions.	750, 1500
Residential proxy country	countryCode	Country for the default residential proxy; US remains the default.	US
Resume partial work	resumeHashtags	Advanced input copied from PENDING_HASHTAGS.	[{"hashtag":"booktok"}]
Proxy configuration	proxyConfiguration	Configure Apify Proxy for TikTok public pages. Residential US proxy is the default.	{"useApifyProxy":true}

Example input

{
  "hashtags": ["booktok", "skincare"],
  "maxItemsPerHashtag": 20,
  "sortMode": "top",
  "includeVideoDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Example output

{
  "hashtag": "booktok",
  "videoId": "7223827494913215786",
  "videoUrl": "https://www.tiktok.com/@jenna_bushhager/video/7223827494913215786",
  "caption": "#WorldBookDay is 4/23...",
  "authorUsername": "jenna_bushhager",
  "authorProfileUrl": "https://www.tiktok.com/@jenna_bushhager",
  "authorDisplayName": "Jenna Bush Hager",
  "createTime": "2023-04-19T18:20:30.000Z",
  "duration": 30,
  "playCount": 39100,
  "diggCount": 993,
  "commentCount": 36,
  "shareCount": 35,
  "coverUrl": "https://...",
  "musicTitle": "original sound",
  "scrapedAt": "2026-06-18T00:00:00.000Z"
}

How to run it

1. Open the Actor on Apify.
2. Add one or more hashtags.
3. Set maxItemsPerHashtag.
4. Choose whether to include technical video details.
5. Keep proxy settings close to the default unless you know another setup works.
6. Start the run and export the dataset.

Search tips

• Use specific hashtags: Niche hashtags usually return cleaner research datasets than very broad tags.
• Compare related tags: Run several hashtags together to compare creators, captions, and engagement.
• Start small: Test 10-20 videos per hashtag before scheduling larger monitoring runs.
• Expect public-page variation: TikTok can localize or limit public hashtag pages by region and availability.
• Do not overclaim comments: This Actor exports hashtag video metadata, not full comment threads.

Limits and caveats

• The Actor extracts publicly visible TikTok hashtag video data only.
• It does not log in, scrape private videos, download video files, or export full comments.
• TikTok may return fewer videos than requested for very broad, blocked, private, or unavailable content.
• A run with no saved public videos fails rather than reporting a misleading empty success. A mixed run can finish as PARTIAL; inspect RUN_SUMMARY and use PENDING_HASHTAGS to retry only unfinished tags.
• TikTok can serve verification or rate-limit pages. The Actor retries transient responses with a fresh browser/proxy route, but cannot guarantee access or a fixed result count.
• Public counts may differ from the TikTok app due to caching, localization, or delayed updates.

Integrations

You can connect hashtag video data to downstream tools:

• Export CSV or Excel to spreadsheets for campaign reports.
• Send creator lists to a CRM or influencer database.
• Load JSON rows into BI dashboards for engagement analysis.
• Trigger webhooks after scheduled trend monitoring runs.
• Combine hashtag outputs with TikTok profile, video, ads, and trends data.

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tiktok-hashtag-scraper').call({
  hashtags: ['booktok', 'skincare'],
  maxItemsPerHashtag: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/tiktok-hashtag-scraper').call(run_input={
    'hashtags': ['booktok', 'skincare'],
    'maxItemsPerHashtag': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~tiktok-hashtag-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"hashtags":["booktok","skincare"],"maxItemsPerHashtag":20}'

MCP and AI agents

This Actor can be used through the official Apify MCP server at https://mcp.apify.com.

Add it to Claude CLI as a focused single-Actor tool:

$claude mcp add apify-tiktok-hashtag --transport http https://mcp.apify.com?tools=fetch_cat/tiktok-hashtag-scraper

Or add the MCP server to a JSON config:

{
  "mcpServers": {
    "apify-tiktok-hashtag": {
      "url": "https://mcp.apify.com?tools=fetch_cat/tiktok-hashtag-scraper"
    }
  }
}

Example prompts:

• "Run TikTok Hashtag Scraper for booktok and return 10 videos."
• "Compare skincare and skincareroutine engagement in a small dataset."

Use the same JSON keys shown in the input configuration table, such as hashtags, maxItemsPerHashtag, sortMode, and includeVideoDetails.

FAQ

Can I scrape multiple TikTok hashtags?

Yes. Add multiple values to hashtags; each saved row includes the source hashtag.

Does it scrape TikTok comments?

No. This Actor exports public hashtag video metadata and engagement counts, not comment threads.

Does it download TikTok videos?

No. It saves video URLs, covers, and metadata. It does not download video files.

Can I export to CSV or Excel?

Yes. Apify datasets can be downloaded as CSV, JSON, Excel, XML, RSS, HTML, or accessed through the API.

Related scrapers

• TikTok Profile Scraper
• TikTok Video Scraper
• TikTok Trends Scraper
• TikTok Ads Library Scraper
• Instagram Stories & Highlights Scraper

Support

If a run fails, returns no data, or a field looks wrong, open an issue from the Actor page.

Please include the Apify run ID or run URL, input JSON, one example public URL, query, or input item, what you expected, and what the dataset returned. Small reproducible inputs make parsing or site-layout issues much faster to fix.

Privacy and data handling

This Actor runs with Apify limited permissions and only processes data needed for the documented run. It uses content lookup inputs and public TikTok hashtag pages needed for the requested output to produce the output dataset; results are stored in Apify run storage for your account. FetchCat does not use your inputs or outputs for advertising, does not use them for model training, and does not retain them outside the Apify run except for transient support debugging when you explicitly share run details. You are responsible for using the Actor lawfully, respecting the target site's terms, and avoiding unnecessary personal or sensitive data in inputs.