Skip to main content
POST
TikTok Creative Center Hashtag Insights API

TikTok Creative Center Hashtag Insights

Dig into a single trending hashtag: its post and view totals, the daily popularity curve, the countries where it is most popular for their size and a set of example videos. The id from TikTok Creative Center Trending Hashtags plugs straight in.
hashtag_id is required; use the id of a TikTok Creative Center Trending Hashtags result together with the same country. time_range (default 7d) picks the period. Returns one result, billed once.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

hashtag_id is required; use an id from TikTok Creative Center Trending Hashtags results, with the same country. Returns one result with the hashtag's post and view counts, popularity curve, top countries and example videos.

hashtag_id
string
required

Hashtag ID from TikTok Creative Center Trending Hashtags results.

Pattern: ^\d{5,32}$
callback_url
string<uri>
country
string
default:US

Two-letter country code of the market, such as US, GB or JP.

Minimum string length: 1
Pattern: ^[A-Za-z]{2}$
time_range
enum<string>
default:7d

Period to analyze: 7d, 30d or 90d.

Available options:
30d,
7d,
90d
Minimum string length: 1

Response

Task accepted

code
integer
data
object