TikTok Hashtag Scraper

Collect public TikTok hashtag videos, captions, creator profiles, and engagement metrics from hashtag pages such as #booktok, #fitness, or #skincare.

What does TikTok Hashtag Scraper do?

TikTok Hashtag Scraper extracts public video rows from TikTok hashtag pages and saves clean, export-ready data to an Apify dataset.

It is built for teams that need a quick view of what videos are ranking for a hashtag, which creators are visible, and how engagement compares across campaigns or niches.

Who is it for?

• 📈 Social media analysts tracking campaign hashtags
• 🧑‍💼 Influencer marketing teams discovering creators
• 📰 Trend researchers monitoring TikTok topics
• 🛍️ Ecommerce teams watching product hashtags
• 🏢 Agencies reporting hashtag performance to clients

Why use it?

Manual TikTok research is slow. This actor turns hashtag pages into structured rows you can filter, export, enrich, and send to dashboards.

What data can I extract?

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 count
diggCount	Like count
commentCount	Comment count
shareCount	Share count
coverUrl	Cover image URL
musicTitle	Music title
scrapedAt	Time the row was collected

How much does it cost to scrape TikTok hashtags?

The actor uses pay-per-event pricing: a small start fee plus a per-video result fee. The exact live price is shown on the Apify Store run screen before you start a paid run.

How to use TikTok Hashtag Scraper

1. Open the actor on Apify.
2. Add one or more hashtags, with or without #.
3. Set the maximum videos per hashtag.
4. Keep the default residential proxy unless you know another proxy works for your account.
5. Run the actor.
6. Download results as JSON, CSV, Excel, XML, or HTML.

Input example

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

Output example

{
  "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"
}

Input fields

hashtags

A list of hashtags to scrape. You can enter booktok, #booktok, or a TikTok tag URL.

maxItemsPerHashtag

Maximum public videos to save for each hashtag. Start small for first runs.

sortMode

TikTok public hashtag pages currently expose a top/trending feed. Recent sorting is not available in this first version.

includeVideoDetails

When enabled, the actor adds optional technical fields such as video width, height, and bitrate when TikTok returns them.

proxyConfiguration

TikTok is sensitive to automated browser traffic. The default uses Apify Residential proxy in the United States for better reliability.

Tips for best results

• ✅ Use specific hashtags rather than extremely broad ones when possible.
• ✅ Keep first runs small while validating a workflow.
• ✅ Use several related hashtags to compare creators and captions.
• ✅ Retry later if TikTok temporarily serves a verification challenge.

Integrations

Use the dataset output with:

• Google Sheets for campaign reporting
• Airtable for creator discovery workflows
• BI dashboards for engagement tracking
• CRM enrichment pipelines
• Apify webhooks for scheduled trend monitoring

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'],
  maxItemsPerHashtag: 20
});
console.log(run.defaultDatasetId);

API usage — Python

from apify_client import ApifyClient

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

API usage — cURL

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

MCP integration

Use this actor from Apify MCP to collect hashtag video rows directly inside Claude Desktop, Claude Code, or another MCP client.

MCP server URL:

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

Claude Code setup:

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

Claude Desktop JSON config:

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

Example prompts:

• “Collect 20 videos for #booktok and summarize the top captions.”
• “Find creators appearing in #skincare with high engagement.”
• “Compare #ai and #marketing TikTok videos.”

Scheduling

You can schedule the actor daily or weekly to monitor how public hashtag results change over time.

Data freshness

TikTok hashtag feeds change frequently. Each run collects the public results available at run time.

Limits

The actor only collects public hashtag video data. It does not log in, collect private data, download videos, or bypass account-only features.

Troubleshooting

Why did the run return no videos?

The hashtag may be empty, region-limited, or TikTok may have served a temporary verification challenge. Try again later or use the default residential proxy.

Why are counts different from the TikTok app?

TikTok updates engagement counts continuously and may personalize or localize public feeds.

Legality

This actor is designed to collect publicly available information. You are responsible for using the data in compliance with applicable laws, TikTok terms, and privacy requirements.

Related scrapers

• https://apify.com/fetch_cat/tiktok-profile-scraper
• https://apify.com/fetch_cat/tiktok-comments-scraper

Support

If a run fails, open an Apify issue with the run URL, input, and expected result so we can investigate.

Changelog

0.1

Initial version for public TikTok hashtag videos.

Notes

This actor focuses on clean normalized output for hashtag research and campaign reporting.

FAQ

Can I scrape multiple hashtags?

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

Can I get comments?

Not in this actor. Use a dedicated TikTok comments scraper for comment collection.

Can I download videos?

No. The output includes public video pages and metadata, not video files.

Can I scrape private videos?

No. Only public hashtag results are supported.