TikTok Hashtag Scraper

Look up a TikTok hashtag by name and get its ID, video count and total views. Tick one box and you get its current top videos instead, each carrying the hashtag's stats.

Input

Field	Use it for
tag_name	Hashtag name, no #. Required. A leading # is stripped if you paste one.
region	Two-letter region code. Default US. Affects the videos only, not the hashtag lookup.
addonHashtagVideos	Return the current top videos as rows instead of the hashtag row. One extra request.

{
  "tag_name": "booktok",
  "region": "US"
}

Two different outputs, depending on one box

This is the thing to understand before you run it.

addonHashtagVideos off (default) -- you get exactly one row: the hashtag itself.

Field	Contents
tag_name	The hashtag you asked for
ch_id	TikTok's hashtag (challenge) ID
hashtag_video_count	Videos reported for the hashtag
hashtag_view_count	Total views reported
ch_info	The full hashtag record

{
  "tag_name": "booktok",
  "ch_id": "10358",
  "hashtag_video_count": 3840000,
  "hashtag_view_count": 219000000000
}

addonHashtagVideos on -- you get one row per video, and no standalone hashtag row. Each video row carries the hashtag fields above plus the video's own:

Field	Contents
aweme_id	Video ID
description	Caption
create_time	Unix timestamp
stats	Play, like, comment and share counts
music_info	The sound used

So if you were expecting the hashtag row and the videos, you will not find it -- the hashtag's numbers ride along on every video row instead. Nothing is lost, but the row count changes shape entirely.

Questions

Why does region do nothing when the add-on is off? Because the hashtag lookup itself is not regional -- a hashtag's ID and lifetime totals are the same everywhere. Region only applies to the top-videos request, which is genuinely different market to market.

I get zero rows with the add-on on. The hashtag exists. The hashtag resolved but TikTok returned no video list for it in that region. Try a different region, or run without the add-on to confirm the hashtag record itself is fine.

How many top videos come back? As many as TikTok serves for that hashtag and region in a single response -- there is no pagination here and no limit setting. For a large, paged sweep of a hashtag's videos, search the tag as a keyword with the Video Search Scraper.

Are hashtag_video_count and hashtag_view_count always present? Not always. TikTok reports them inconsistently across hashtags, and when a count is missing it comes back as null rather than 0 -- so you can tell "not reported" apart from "genuinely zero".

Can I pass more than one hashtag? No, one per run.

Related Actors

Actor	Purpose
TikTok Video Search Scraper	Paginated keyword search, when one page of top videos is not enough
TikTok Sound & Music Scraper	The same pattern for a sound instead of a hashtag