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
| Parameters | Required | Description |
|---|---|---|
hashtags | Required | One 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.
- POST {"hashtags": ["cooking", "booktok"]} to /v1/tiktok/hashtag-detail.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
Beyond the TikTok Hashtag Views API, use these APIs when you need a different type of public TikTok data.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Search Users API — Search public TikTok accounts by keyword.
- TikTok Top Search API — Search by keyword for videos and image posts, with captions, creators and interaction counts.
- TikTok Trending Searches API — Get today's trending searches on TikTok in ranked order.
- TikTok Profiles API
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API