Skip to main content
POST
TikTok Hashtag Views API

TikTok Hashtag Views

Measure how big a hashtag is on TikTok: the total number of videos posted with it and their combined views. Send up to 20 hashtags in one request and compare the candidates side by side before you settle on the tags for a campaign.
hashtags is required: 1 to 20 hashtag names, with or without #. Each hashtag that exists returns one result and is billed per result; hashtags that do not exist are skipped.

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

hashtags is required: 1 to 20 hashtag names. Returns one result per hashtag with its total video count and view count.

hashtags
string[]
required

Hashtag names with or without the # prefix, up to 20 per request.

Required array length: 1 - 20 elements
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object