Appearance
Get popular hashtags
GET /v1/tiktok/hashtags/popular
Discovers trending and popular TikTok hashtags, filterable by time period (7/30/120 days) and country. Returns a list of hashtag objects each with hashtag_name, rank, trend data, and related video examples. Useful for identifying viral topics and content trends on TikTok.
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
period | enum(7, 30, 120) | no | Time period in days (7, 30, or 120) | 7 |
page | number | no | Page number | 1 |
countryCode | enum(AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN) | no | Country code to get popular hashtags from | US |
newOnBoard | boolean | no | Show only newly trending hashtags | |
industry | enum(apparel-and-accessories, baby-kids-and-maternity, beauty-and-personal-care, business-services, education, financial-services, food-and-beverage, games, health, home-improvement, household-products, life-services, news-and-entertainment, pets, sports-and-outdoor, tech-and-electronics, travel, vehicle-and-transportation) | no | Industry to get popular hashtags from. |
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/tiktok/hashtags/popular' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ });
const res = await fetch(`https://api.scrapecreators.com/v1/tiktok/hashtags/popular?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/tiktok/hashtags/popular',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators tiktok hashtags-popular --helpExample Response
json
{
"success": true,
"credits_remaining": 100,
"list": [
{
"hashtag_id": "1601724235290629",
"hashtag_name": "2026",
"country_info": {
"id": "US",
"value": "United States",
"label": "US"
},
"is_promoted": false,
"trend": [
{
"time": 1767225600,
"value": 0.28
}
],
"creators": [
{
"nick_name": "66",
"avatar_url": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/7d641185c35d67d35de1a7a4f40b4199~tplv-tiktokx-cropcenter:100:100.png?dr=14579&refresh_token=408c3c44&x-expires=1768082400&x-signature=h9plkIGtBdSgZ8YIQZQ5yLUsSAM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=317596d8&idc=my2"
}
],
"publish_cnt": 1554523,
"video_views": 3251352710,
"rank": 1,
"rank_diff": 0,
"rank_diff_type": 2
}
],
"pagination": {
"page": 1,
"size": 20,
"total": 100,
"has_more": true
}
}Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |