Unofficial TikTok API — Country Trends
GET/api/v1/country_trends
TikTok Creative Center trending hashtags for one country (region-selected, not IP-selected). ~3 hashtags per country — a trend signal, not a full list.
| Parameter | Description | |
|---|---|---|
region | optional | ISO-2 country code (default US). Supported values come back in supported_regions (27 countries incl. SA, EG, AE). |
period | optional | Trend window in days: 7 (default) or 30. |
format | optional | Omit for raw Creative Center objects (default). Use clean for a trimmed subset (rank, hashtag, posts, views, popularity, top creators). |
Returns
region, period, injected_country, supported_regions, count and a hashtags array.
Example Request
https://dev.omar-thing.site/api/v1/country_trends?region=SA&period=7&format=clean&key=YOUR_API_KEY
Example Response
{
"data": {
"count": 3,
"hashtags": [
{
"hashtag": "saudinationalday",
"hashtag_id": "31855684",
"popularity": [
{
"timestamp": "1789603200",
"value": 0
}
],
"posts": 20580,
"rank": 1,
"top_creators": [
{
"followers": 1200000,
"handle": "…",
"nickname": "…"
}
],
"views": 131623155
}
],
"injected_country": "SA",
"period": 7,
"region": "SA",
"supported_regions": [
"US",
"FR",
"DE",
"EG",
"SA",
"AE",
"..."
]
},
"status": "success"
}Sends a live request using your API key above.
More Search endpoints
- Unofficial TikTok User Search API — Search users/accounts (one page per call, cursor-paginated). Filter by
followers,verifiedaccounts, ormatchusernames only. - Unofficial TikTok Video Search API — Search videos (one page per call, cursor-paginated). Filter by
dateand sort bylikesornewest. - Unofficial TikTok Photo Search API — Search photo/slideshow posts (one page per call, cursor-paginated).
- Unofficial TikTok Hashtag Search API — Search hashtags (one page per call, cursor-paginated).
- Unofficial TikTok Place Search API — Search places/POIs (venues, landmarks, restaurants). Results are localized to the
countryyou pass (ISO-2). One page per call, cursor-paginated. - Unofficial TikTok Music Search API — Search sounds/music (one page per call, cursor-paginated).
- Unofficial TikTok Search Suggestions API — Search autocomplete — the suggestions shown while you type.
- Unofficial TikTok Related Searches API — Related search terms suggested under a video ("others searched for"). Add
queryto steer them toward a topic.