curl --request POST \
--url https://api.scrapeunblocker.com/social/tiktok-hashtag \
--header 'x-scrapeunblocker-key: <api-key>'import requests
url = "https://api.scrapeunblocker.com/social/tiktok-hashtag"
headers = {"x-scrapeunblocker-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};
fetch('https://api.scrapeunblocker.com/social/tiktok-hashtag', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Scrape a TikTok hashtag - totals and top videos
Fetches a TikTok hashtag page for hashtag and returns it as JSON: hashtag, id, url, stats (total views and videos under the tag) and a videos array of its top posts (up to 10). With video_details=true (default) every listed video carries the full /social/tiktok-video shape - exact plays, likes, comments, shares, saves, hashtags, author with follower counts, music, media URLs and timestamps - which makes the response a ready trend / creator discovery sample. hashtag accepts a bare name, #name or a tag URL. No login or cookies.
curl --request POST \
--url https://api.scrapeunblocker.com/social/tiktok-hashtag \
--header 'x-scrapeunblocker-key: <api-key>'import requests
url = "https://api.scrapeunblocker.com/social/tiktok-hashtag"
headers = {"x-scrapeunblocker-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};
fetch('https://api.scrapeunblocker.com/social/tiktok-hashtag', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Your ScrapeUnblocker API key. Apply on every request.
Query Parameters
Hashtag name ('nasa' or '#nasa') or a hashtag URL like 'https://www.tiktok.com/tag/nasa'.
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.
0 <= x <= 200Fetch 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.
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).

