TikTok Hashtag Scraper — Stats & Top Videos

Turn a TikTok hashtag name into one structured metadata record.

TikTok Hashtag Scraper looks up a public hashtag by name and returns its TikTok challenge ID, identity fields, and available statistics. Current top videos stay optional, so a metadata check does not automatically become a video-collection run.

Enter the hashtag, not an internal ID

Enter cats rather than #cats or a numeric challenge ID. Choose a region only when you enable Add Hashtag Videos; the region affects that optional video request.

Look up a hashtag

Enter a hashtag name without #. Metadata mode returns one hashtag row; Add Hashtag Videos returns one row per current top video with hashtag context.

Field	Type	Required	Description
tag_name	string	Yes	TikTok hashtag name without the # symbol.
region	string	No	Two-letter region code affecting search/feed results, e.g. US, GB, JP.
enrichHashtagVideos	boolean	No	Return each current top video as a separate row with hashtag context. One extra request.

{
  "tag_name": "cats",
  "region": "US",
  "enrichHashtagVideos": false
}

Choose a metadata dataset or a video dataset

With Add Hashtag Videos off, the Actor saves one hashtag metadata row. With it on, the Actor saves only video rows—one row per returned video—with tag_name, ch_id, and ch_info repeated on every row. It never hides the videos inside a hashtag_videos array.

Both modes expose hashtag_video_count and hashtag_view_count as top-level columns. Each video also keeps the upstream fields and adds stable aliases such as description, stats, and music_info, so JSON users retain the original payload while CSV and table users get predictable columns. Counts can be absent or zero when the public source does not provide them.

🏷️ Hashtag identity

Field	Type	Description
tag_name	mixed	TikTok hashtag name used for the lookup.
ch_id	mixed	TikTok hashtag/challenge ID.
hashtag_video_count	mixed	Number of videos reported for the hashtag, when available.
hashtag_view_count	mixed	Total hashtag views reported by TikTok, when available.
ch_info	object	Hashtag info, when available.

🎬 Video rows when enabled

Field	Type	Description
aweme_id	string	TikTok video ID.
description	mixed	Video caption or user bio, when available.
create_time	mixed	Creation timestamp, when available.
stats	object	Engagement stats (likes/comments/shares/plays or followers/following/hearts), when available.
music_info	object	Music/sound info attached to a video, when available.

{
  "tag_name": "cats",
  "ch_id": "5216",
  "hashtag_video_count": 0,
  "hashtag_view_count": 424700000000,
  "ch_info": {
    "challenge": {
      "id": "5216",
      "title": "cats"
    },
    "stats": {
      "videoCount": 0,
      "viewCount": 424700000000
    }
  }
}

Pay for the rows you request

Metadata mode saves and charges one hashtag row. Add Hashtag Videos mode saves and charges one row per returned video, plus one add-on event after the video request succeeds.

Apify's free credits may cover a one-hashtag metadata test before enabling the optional video request.

Video mode returns a video-only dataset with hashtag context repeated on every row; current tier prices are shown on the Actor Pricing tab.

Responsible hashtag-data use

This Actor extracts publicly available TikTok content. It should not be used to collect private user data. Make sure your use case complies with applicable privacy laws, TikTok's terms, and your own legal obligations. If you are unsure, consult a qualified lawyer.

Run this Actor from code

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")
run = client.actor("toolzerhub/tiktok-hashtag-scraper").call(run_input={
    "tag_name": "cats",
    "region": "US",
    "enrichHashtagVideos": false
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Node.js

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_APIFY_API_TOKEN" });
const run = await client.actor("toolzerhub/tiktok-hashtag-scraper").call({
  "tag_name": "cats",
  "region": "US",
  "enrichHashtagVideos": false
});

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

Search for videos, or look up a sound

• TikTok Video Search Scraper — Full Details — Search public TikTok videos by keyword with automatic pagination. Export video IDs, captions, timestamps, statistics, and music data, with optional full-detail enrichment per result.
• TikTok Sound & Music Scraper — Track Videos — Fetch TikTok sound information by music ID or collect videos using that sound as separate rows with music context, captions, and engagement statistics.
• Bulk TikTok Video Scraper — URLs, Stats & Music — Fetch multiple public TikTok videos from IDs, full video URLs, or vt/vm share links. Export one row per video with captions, timestamps, engagement statistics, and music metadata.

ToolzerHub support

Use the Issues tab on the Actor page for bug reports, missing fields, and feature requests.

Contact: contact@toolzerhub.com