tiktok/
hashtag-detail

Check how many videos and how many total views up to 20 TikTok hashtags have in one TikTok Hashtag Views API request, with each hashtag's ID and tag-page link for side-by-side comparison.

TikTok Hashtag Views API

Up to 20 hashtags
Total views
Video count
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Hashtag Views

A TikTok hashtag page rolls every public video that uses the tag into two cumulative totals: how many videos carry it and how many views those videos have drawn. Read together they show how big and how crowded a topic is, and views per video hints at how well content under the tag tends to perform.

TikTok Hashtag Views API Features

  • Up to 20 hashtags per requestSend 1 to 20 names, with or without the #, and get one record for every hashtag that exists.
  • Totals as whole numbersIn the TikTok Hashtag Views API, metrics.posts_count and metrics.views_count come back as plain integers rather than abbreviated strings, so they sort and divide directly.
  • Hashtag ID and tag-page linkid holds TikTok's numeric hashtag ID and url the tag page, which gives each record a key you can join across runs.

TikTok Hashtag Views API Parameters

ParametersRequiredDescription
hashtagsRequiredOne to 20 hashtag names, with or without the # prefix.

How to Use the TikTok Hashtag Views API

Send a list of hashtags to the TikTok Hashtag Views API and read one record per tag.

  1. POST {"hashtags": ["cooking", "booktok"]} to /v1/tiktok/hashtag-detail.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read name, metrics.posts_count and metrics.views_count for each hashtag from results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count is the video count; metrics.views_count is the total views.

TikTok Hashtag Views API Use Cases

  • Shortlisting campaign hashtags: Put the candidate tags in one request and compare posts_count for crowding against views_count for reach before you commit to a set.
  • Branded hashtag monitoring: Pull your campaign tag from the TikTok Hashtag Views API on a schedule and chart how its video count and total views climb after each push.
  • Topic size research: Look up the tags that define a niche, a trend or a public issue and compare their totals to see where the content on that subject concentrates.

TikTok Hashtag Views API Pro Tips

  • Do not add views_count across hashtags to size a topic, because a video that carries several of them is counted under each; compare tags side by side or use the largest.
  • Divide views_count by posts_count only when posts_count is present and above zero, then rank tags by average views per video to compare very different sizes.
  • Store each result with its collected_at time when you track a tag; every request returns the current totals, so growth only appears if you keep the earlier snapshots.
  • Match TikTok Hashtag Views API results to your input list by name or id, not by position, since a hashtag that does not exist is skipped and the output can be shorter than the input.

Beyond the TikTok Hashtag Views API, use these APIs when you need a different type of public TikTok data.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Hashtag Views API — FAQ

TikTok Hashtag Views API is a programmatic interface for looking up the totals of up to 20 TikTok hashtags by name. It returns each hashtag's ID, page URL, video count and total views.

Send the hashtag name and read metrics.views_count for the total views and metrics.posts_count for the number of videos that use the tag. Both are cumulative figures for the hashtag as a whole.

The response carries metrics.views_count next to metrics.posts_count for each hashtag, and a counter TikTok does not report for a tag comes back as null.

Up to 20, written with or without the #. Each existing hashtag returns its own record, so a whole shortlist can be compared from one result.

It is left out of the results and not charged, while the other hashtags in the request still return. A request in which none of the hashtags exist costs nothing.

The endpoint returns the current totals with a collected_at time and no history. Run it on a schedule and keep each snapshot to chart growth.

No, only the hashtag's totals and identifiers. Use TikTok Hashtags to collect the videos themselves.

Per hashtag that exists, at 0.5 credits each. A list of 20 existing tags therefore costs 10 credits, and a request with no matches costs nothing.