TikTok API
TikTok Trending hashtags API
Rank TikTok's trending hashtags for one country and industry, with each hashtag's daily popularity curve, post count, video views, and leading creators. Ranks 15 industry categories, or omit industry for the all-industries board. TikTok publishes only the top 3 hashtags per board to anonymous callers, so limit 1-3 is served cheaply; a limit above 3 routes to a dearer authenticated source that returns the full ranking. Covers 27 markets: AE, AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IL, IT, JP, KR, MX, MY, PH, SA, SG, TH, TR, TW, US, VN, ZA.
POST/v1/run/tiktok.trending_hashtags
Uptime
100.00%
30d · 34 calls
Requests
34
30d · weekly, last 12 wks
Response
0.8s
median · 30d
Provider network
Providers ranked by traffic
Providers
TigerTried first31 served100.00% uptime660ms p5091.2%$1.20/1k reqflat
Octopus3 served100.00% uptime4181ms p508.8%$1.10/1k resultsup to $0.11 / requestMetered per result returned$0.0275 base + $0.00083 per resultcapped at $0.11 per request1 result$0.0283350 results$0.069100 results$0.11 capYou are charged for what comes back. Lower the limit to pay less - and no single request can cost more than the cap, however much comes back.
Call it
Make your first request
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/tiktok.trending_hashtags", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={}, ) print(res.json())
Sample response
{
"data": {
"items": [
{
"hashtag": "a1b2c3d4",
"hashtagId": "a1b2c3d4",
"industryIds": [
1024
],
"popularity": [
{
"atUtc": 12.5,
"value": 19.99
}
],
"posts": 248,
"rank": 1,
"topCreators": [
{
"countryCode": "US",
"followers": 12500,
"handle": "alex_rivera",
"image": "https://example.com/image.jpg",
"nickname": "Example title",
"rank": 1,
"userId": "a1b2c3d4"
}
],
"views": 12500
}
]
},
"found": true
}Response interface
interface TiktokTrendingHashtagsResponse {
data: {
items: {
hashtag: string;
hashtagId: string;
industryIds?: number[];
popularity?: {
atUtc: number;
value: number;
}[];
posts?: number;
rank: number;
topCreators?: {
countryCode?: string;
followers?: number;
handle?: string;
image?: string;
nickname?: string;
rank?: number;
userId?: string;
}[];
views?: number;
}[];
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-09-14 · uptime and latency measured over 30dPOST /v1/run/tiktok.trending_hashtags
curl -X POST https://api.getanyapi.com/v1/run/tiktok.trending_hashtags \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":3,"period":7,"region":"US"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| industry | enum | Restrict the ranking to one industry. Omit for the all-industries board. |
| limit | integer | 3Maximum number of ranked hashtags to return, from 1 through 100 (default 3). TikTok publishes only the top 3 hashtags per board to anonymous callers, so 1 through 3 is served by the cheapest source; a higher limit routes to a dearer source that reads the full ranking. |
| period | enum | 7Lookback window in days that the ranking and the popularity curve cover (default 7). |
| region | enum | "US"Two-letter country code of the market whose hashtag ranking to read (default US). Each market is ranked independently, so US and DE return different boards. |
| requireFields | array | Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `industryIds`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a hashtag that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. |
| Response | ||
| data | object | The ranked hashtags for the requested market, or null when unavailable. |
| data.items | object[] | Hashtags in the market's own ranking order, best first. Populated whenever the provider has data for the entity. |
| data.items[].hashtag | string | Hashtag name without the leading #. Populated whenever the provider has data for the entity. |
| data.items[].hashtagId | string | Stable TikTok hashtag identifier. Populated whenever the provider has data for the entity. |
| data.items[].industryIdscan require | integer[] | TikTok industry identifiers the hashtag is classified under, matching the ids behind the `industry` input. Empty when TikTok classifies the hashtag under none. |
| data.items[].popularity | object[] | Daily popularity curve across the requested period, oldest first. Values are normalized 0-100 within this hashtag's own window, where 100 is its peak day, so they compare days of one hashtag rather than two hashtags. Populated whenever the provider has data for the entity. |
| data.items[].popularity[].atUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].popularity[].value | number | Normalized popularity for that day, 0 through 100. |
| data.items[].posts | integer | Number of videos published with the hashtag during the period. Populated whenever the provider has data for the entity. |
| data.items[].rank | integer | One-based position in this market's ranking for the requested period. Populated whenever the provider has data for the entity. |
| data.items[].topCreatorscan require | object[] | Creators TikTok surfaces as leading the hashtag, in its own order. |
| data.items[].topCreators[].countryCode | string | Two-letter country code TikTok reports for the creator. |
| data.items[].topCreators[].followers | integer | Creator's follower count. |
| data.items[].topCreators[].handle | string | Creator's TikTok username without the leading @. |
| data.items[].topCreators[].image | string | Creator's avatar image URL. |
| data.items[].topCreators[].nickname | string | Creator's display name. |
| data.items[].topCreators[].rank | integer | One-based position among the hashtag's top creators. |
| data.items[].topCreators[].userId | string | Creator's stable TikTok user id. |
| data.items[].views | integer | Total video views the hashtag drew during the period. Populated whenever the provider has data for the entity. |
| found | boolean | Whether a hashtag ranking was resolved for the requested market. |
| Price | ||
| Price per request | USD | $0.0012 |
| Price /1k req | USD | $1.20 |
FAQ
About the TikTok Trending hashtags API
The AnyAPI TikTok Trending hashtags API returns TikTok trending hashtags data as normalized JSON from one POST call to /v1/run/tiktok.trending_hashtags. Rank TikTok's trending hashtags for one country and industry, with each hashtag's daily popularity curve, post count, video views, and leading creators. Ranks 15 industry categories, or omit industry for the all-industries board. TikTok publishes only the top 3 hashtags per board to anonymous callers, so limit 1-3 is served cheaply; a limit above 3 routes to a dearer authenticated source that returns the full ranking. Covers 27 markets: AE, AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IL, IT, JP, KR, MX, MY, PH, SA, SG, TH, TR, TW, US, VN, ZA. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of TikTok trending hashtags calls through AnyAPI succeeded, with a median response time of 0.8 seconds across 34 measured calls.
It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.
Rank TikTok's trending hashtags for one country and industry, with each hashtag's daily popularity curve, post count, video views, and leading creators. Ranks 15 industry categories, or omit industry for the all-industries board. TikTok publishes only the top 3 hashtags per board to anonymous callers, so limit 1-3 is served cheaply; a limit above 3 routes to a dearer authenticated source that returns the full ranking. Covers 27 markets: AE, AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IL, IT, JP, KR, MX, MY, PH, SA, SG, TH, TR, TW, US, VN, ZA. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.
Over the last 30 days, 100.0% of TikTok trending hashtags calls through AnyAPI succeeded, with a median response time of 0.8 seconds across 34 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call
Other TikTok endpoints
Profilefrom $0.50 /1k reqProfile videosfrom $1.20 /1k reqVideo transcriptfrom $1.20 /1k reqKeyword searchfrom $1.20 /1k reqVideofrom $0.50 /1k reqVideo commentsfrom $0.80 /1k reqUser searchfrom $1.20 /1k reqAd library adfrom $1.20 /1k reqAd library searchfrom $1.20 /1k reqAd transparency searchfrom $0.50 /1k reqAudience demographicsfrom $18.00 /1k reqComment repliesfrom $1.20 /1k reqFollowersfrom $1.20 /1k reqFollowingfrom $1.20 /1k reqHashtag videosfrom $0.80 /1k reqLivefrom $1.20 /1k reqPhotosfrom $1.20 /1k reqProfile contactfrom $1.16 /1k reqProfile regionfrom $1.20 /1k reqSearch hashtagfrom $1.20 /1k reqSearch topfrom $1.20 /1k reqSongfrom $1.20 /1k reqSong videosfrom $1.20 /1k reqTop ads searchfrom $1.20 /1k reqTrending feedfrom $1.20 /1k reqVideo downloadfrom $1.20 /1k reqVideo transcript fullfrom $17.60 /1k req