Skip to main content
Scrape a TikTok hashtag - totals and top videos

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

hashtag
string
required

Hashtag name ('nasa' or '#nasa') or a hashtag URL like 'https://www.tiktok.com/tag/nasa'.

max_videos
integer
default:10

How many of the hashtag's videos to include (0-200). 0 = totals only. Up to 10 top videos come from TikTok's server-rendered widget in a couple of seconds; asking for more opens the hashtag page in a browser and scrolls the real grid (about 30 videos a batch, 10-30 s), all with full details.

Required range: 0 <= x <= 200
video_details
boolean
default:true

Fetch each listed video's own page for full engagement, hashtags, author stats, music and media URLs. false = only id, caption, cover, author handle and play count.

proxy_country
string | null

Exit-IP country (ISO-2, e.g. 'US', 'DE'). Optional - TikTok's public pages are the same worldwide; set it only for region-restricted items.

Response

JSON hashtag object with a videos array (videosCollected gives its length).