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.
• 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.

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.

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.
• 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.

For a focused single-Actor tool setup, use:

https://mcp.apify.com?tools=fetch_cat/tiktok-hashtag-scraper

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

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.