How to track TikTok hashtag views and video counts over time
Track a TikTok hashtag's total views and video count over time with daily JSON snapshots: what the stats include, what they don't, 1 credit per lookup.
By Scrape Everything team · · 11 min read
Last updated: November 21, 2026
TL;DR: Scrape Everything's TikTok hashtag API (tiktok.hashtag) returns the public stats of one hashtag as JSON: view_count, video_count, description, the branded is_commerce flag, ID, link and cover image. Each lookup costs 1 credit and accepts the tag with or without #, or a tiktok.com/tag URL. It returns stats, not the videos under the tag, so for growth you store daily snapshots and diff them.
If you came here for the video feed under a hashtag, skip to the section on getting videos. We'd rather tell you now than after you've written the integration.
How do I check a TikTok hashtag's views with an API?
Send one POST request with the hashtag name and read two numbers back: total views and total videos, as TikTok shows them at the moment of the request.
A hashtag stats API is an endpoint that takes a hashtag name and returns its aggregate public numbers (videos, views, metadata) instead of individual posts. The TikTok hashtag scraper page has the full parameter reference.
- Sign in with Google or GitHub. New accounts get 100 free credits, no payment details needed.
- Copy your API key (it starts with
ssk_live_) and export it asSCRAPEEVERYTHING_API_KEY. - POST
{"hashtag": "..."}tohttps://api.scrapeeverything.com/v1/tiktok/hashtag. - Read
data.view_countanddata.video_countfrom the response.
The cURL version, using the example tag from our catalog:
curl -X POST https://api.scrapeeverything.com/v1/tiktok/hashtag \
-H "Authorization: Bearer $SCRAPEEVERYTHING_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag": "learnfromkhaby"}'A trimmed response. Field names match the catalog; the numbers and IDs are placeholders, so run the call yourself for live values:
{
"success": true,
"data": {
"id": "1234567890123456789",
"title": "learnfromkhaby",
"description": "Example hashtag description",
"link": "https://www.tiktok.com/tag/learnfromkhaby",
"video_count": 123456,
"view_count": 987654321,
"cover_url": null,
"is_commerce": false
},
"meta": { "credits_charged": 1, "cached": false }
}The same lookup in Python, with the error handling you'll want in real code:
import os
import requests
API = "https://api.scrapeeverything.com/v1/tiktok/hashtag"
HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPEEVERYTHING_API_KEY']}"}
def hashtag_stats(tag: str) -> dict:
res = requests.post(API, headers=HEADERS, json={"hashtag": tag}, timeout=30)
try:
payload = res.json()
except ValueError:
raise RuntimeError(f"HTTP {res.status_code}: non-JSON body")
if res.status_code != 200 or not payload.get("success"):
raise RuntimeError(f"HTTP {res.status_code} {payload.get('code')}: {payload.get('message')}")
return payload["data"]
d = hashtag_stats("#LearnFromKhaby")
print(d["title"], d["video_count"], d["view_count"], d["is_commerce"])Errors come back as success: false with a stable code. Branch on the code, not the message: 402 INSUFFICIENT_CREDITS means your balance is lower than the call's cost, and 429 RATE_LIMITED means you sent too much this minute. The error reference lists the rest. Neither of those is charged. Blocks, timeouts and 5xx errors are refunded automatically, while a definitive 404 is a final answer and is charged.
Which hashtag stats can you track?
Eight fields, all from public TikTok data. This table comes straight from our endpoint catalog.
| Field | Type | Can be null | What it is |
|---|---|---|---|
id | string | yes | Hashtag ID (TikTok calls hashtags "challenges" internally) |
title | string | no | Hashtag name without # |
description | string | no | Hashtag description |
link | string | yes | Hashtag page URL on tiktok.com |
video_count | integer | yes | Number of videos with the hashtag |
view_count | integer | yes | Total views of those videos |
cover_url | string | yes | Hashtag cover image URL (null for both tags we tested) |
is_commerce | boolean | no | Branded (commercial) hashtag |
What you won't get: hashtag-level likes, shares or comments, any history (each call is a snapshot of current totals), or splits by region or demographic.
Matching is case-insensitive, so #LearnFromKhaby and learnfromkhaby are the same tag. You can look a tag up by name, by name with #, or by its tiktok.com/tag URL. The hashtag parameter doesn't take the numeric ID.
One schema detail that bites people: video_count and view_count are nullable. Store them as optional instead of defaulting to zero. A zero would look like a collapse in a growth chart.
The number is TikTok's public total at request time. If it differs from what you saw in the app an hour ago, the count moved. We don't know TikTok's internal refresh schedule and won't guess at it.
I need the videos under a hashtag. What are my options?
We don't offer the hashtag video feed. Here's what to use instead, depending on what you actually need:
| You need | Use |
|---|---|
| Views and video count for your own list of tags, daily | tiktok.hashtag (1 credit) |
| Which hashtags are trending right now | TikTok Creative Center |
| Videos under a hashtag, for non-commercial research | TikTok Research API, if you qualify |
| Newest videos from creators you already know | tiktok.posts (1 credit, up to 12 newest, with play_count) |
| Full stats for a video you have a link to | tiktok.video (1 credit) |
| Top videos using a sound | tiktok.music (2 credits, up to 12) |
| The full video feed under a hashtag, commercially | A provider with hashtag video search. We don't offer it. |
The tiktok.video endpoint returns play_count, like_count, comment_count, share_count and save_count for one video. Sound-led trends are often easier to follow through the sound than the tag, which is where tiktok.music helps. All of these live on the TikTok scraper hub, and the TikTok scraper API guide walks through each endpoint. For a list of commercial providers, some of which do sell hashtag video search, see our comparison of TikTok scraper APIs (prices verified October 2026; they may change).
How do I track TikTok hashtag growth over time?
Take one snapshot per hashtag per day, store it with the date, and subtract. Most TikTok hashtag analytics is arithmetic once the rows exist.
- Keep a list of the hashtags you want to watch.
- Once a day, call
tiktok.hashtagfor each one and savedate,title,video_countandview_count, plus the raw JSON. - For each tag, subtract the previous day's row from today's to get new videos and new views.
- Divide the view gain by the previous total to get a growth rate, and compare rates across tags.
This script appends to a CSV, keeps the raw responses in a JSONL file, skips same-day reruns and prints the change since the last stored date:
import csv
import datetime as dt
import json
import os
import requests
API = "https://api.scrapeeverything.com/v1/tiktok/hashtag"
HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPEEVERYTHING_API_KEY']}"}
TAGS = ["learnfromkhaby", "booktok", "skincareroutine"]
CSV_FILE = "hashtag_snapshots.csv"
RAW_FILE = "hashtag_raw.jsonl"
def load_last(path):
last = {}
if os.path.exists(path):
with open(path, newline="") as f:
for row in csv.DictReader(f):
last[row["title"]] = row # rows are in date order, latest wins
return last
last = load_last(CSV_FILE)
today = dt.date.today().isoformat()
is_new = not os.path.exists(CSV_FILE)
with open(CSV_FILE, "a", newline="") as f, open(RAW_FILE, "a") as raw:
w = csv.DictWriter(f, fieldnames=["date", "title", "video_count", "view_count"])
if is_new:
w.writeheader()
for tag in TAGS:
res = requests.post(API, headers=HEADERS, json={"hashtag": tag}, timeout=30)
try:
payload = res.json()
except ValueError:
print(tag, "failed: HTTP", res.status_code)
continue
if not payload.get("success"):
print(tag, "failed:", res.status_code, payload.get("code"))
continue
d = payload["data"]
prev = last.get(d["title"])
if prev and prev["date"] == today:
continue # already snapshotted today
raw.write(json.dumps({"date": today, **d}) + "\n")
w.writerow({"date": today, "title": d["title"],
"video_count": d["video_count"], "view_count": d["view_count"]})
if prev and prev["view_count"] and d["view_count"] is not None:
gain = d["view_count"] - int(prev["view_count"])
rate = gain / int(prev["view_count"])
print(f"{d['title']}: +{gain:,} views ({rate:.2%}) since {prev['date']}")The printed rate covers the whole gap since the last stored date, so if a run is missed it spans two days. Divide by days elapsed if you need a strict daily rate.
Run it from cron, a GitHub Action or an n8n workflow. What we'd do when building one of these:
- Compare rates, not totals. A tag with a billion views that gained 0.1% overnight is growing slower, relative to its size, than a two-million-view tag that gained 15%. The small one is usually the one worth acting on.
- Keep the raw JSONL. If you later want a field you didn't put in the CSV, it's already there.
- Leave
cache_daysoff the scheduled snapshot. With it on, a request can return a stored result up to that many days old for 0 credits, which suits a dashboard someone reloads all day and breaks a daily diff. The caching docs cover the 1 to 14 day window. - For thousands of tags, run requests in parallel up to your limit. The free plan allows 60 requests per minute and 5 concurrent; buying any pack raises that to 300 per minute and 20 concurrent. Details are in the rate limit docs.
How much does it cost to track TikTok hashtag stats every day?
One lookup is 1 credit. Credits come in one-time packs that never expire, so the math is simple:
| Tags tracked daily | Credits per 30 days | Smallest pack that fits | Pack lasts | Effective cost per month |
|---|---|---|---|---|
| 100 | 3,000 | Builder ($19.99, 25,000) | 250 days | $2.40 |
| 500 | 15,000 | Builder ($19.99, 25,000) | 50 days | $11.99 |
| 2,000 | 60,000 | Growth ($299, 500,000) | 250 days | $35.88 |
| 10,000 | 300,000 | Growth ($299, 500,000) | 50 days | $179.40 |
A full year of tracking 100 tags is 36,500 credits. One Growth pack covers it with about 463,500 credits left over, and nothing expires. The pricing page lists every pack, and the credit calculator works it out for your own volume.
Is there an official TikTok hashtag API?
TikTok has no public hashtag stats API for commercial use. The Research API covers approved non-commercial researchers only, and Creative Center is a web tool, not an API.
The TikTok Research API gives approved researchers public data straight from TikTok, including video queries you can filter by hashtag_name. Eligibility is narrow: academic institutions and not-for-profit research organizations in specific regions, working independently of commercial interests. Check TikTok's page for the current list of regions, since it changes. If you qualify, use it. First-party access is the better foundation for published research. Our post on TikTok Research API alternatives covers what to do if you don't.
TikTok Creative Center is TikTok's hub for advertisers. Its Trends section ranks popular hashtags with performance figures in the web UI, which makes it the right place for discovery: finding out which tags are hot this week. Where it falls short is lookup. You can't hand it your own list of 500 tags and get their numbers into a database every morning.
That split is the real decision. Discovery belongs in Creative Center. Lookup on a fixed list belongs in an API.
| TikTok Research API | TikTok Creative Center | Scrape Everything tiktok.hashtag | |
|---|---|---|---|
| Who can use it | Approved academic and not-for-profit researchers | Advertisers and marketers | Anyone with an API key |
| Access | Application and approval | Web interface | REST API, JSON |
| Best for | Non-commercial research on videos | Discovering trending hashtags | Daily numbers for tags you choose |
| Look up any tag you choose | Via video queries (hashtag_name) | Built around ranked trends | Yes, one tag per call |
| Returns videos | Yes | Not an API | No, stats only |
| Views and video count | You aggregate from video results | Trend figures in the web UI, for ranked tags only | view_count, video_count |
| Scheduled export to your database | Within research terms | No | Yes |
| Commercial use | No | Built for advertisers | Yes |
How can I use is_commerce to spot branded hashtag challenges?
is_commerce is the boolean TikTok returns to mark a hashtag as branded, or commercial. We pass it through as reported. We haven't found TikTok documentation on how the flag gets set, so treat it as one signal, read alongside the description text and the growth in video_count.
- Competitor monitoring: check the tags on competitors' campaigns. A
trueflag plus a sharp jump invideo_countsuggests a branded push rather than organic spread. - Cleaning trend lists: when ranking candidate tags for your own content, filter out
is_commerce: trueso you aren't riding another brand's challenge. - Campaign reporting: if you ran a branded challenge, confirm the flag and track daily participation through
video_count.
Is it legal to collect TikTok hashtag stats?
Hashtag stats are aggregate public counts: a view total, a video total and a description. They contain no personal data about the people who posted. We return public data only, never data from private accounts. You're still responsible for how you use and store the data under TikTok's terms and the laws that apply to you. Our guide on whether scraping public social media data is legal goes into the details. It's background, not legal advice.
Can an AI agent call the hashtag endpoint?
Yes. Through our MCP server (@scrapeeverything/mcp, listed in the official MCP Registry as io.github.scrapeeverything/mcp), an assistant like Claude gets one tool per endpoint and can answer "how many views does #booktok have right now?" with a live call. For quick checks from a terminal there's the CLI (npx scrapeeverything), and the n8n node (n8n-nodes-scrapeeverything) runs the daily tracker without code. To generate a client, use the OpenAPI spec at https://scrapeeverything.com/openapi.json.
FAQ
Does the TikTok hashtag API return the videos under a hashtag?
No. tiktok.hashtag returns stats only: video_count, view_count, description, is_commerce, ID, link and cover image. For video-level numbers, use tiktok.video on links you already have, or tiktok.posts for a creator's 12 newest videos.
How do I check hashtag views on TikTok without the app?
Call the endpoint with the tag name and read view_count. One lookup costs 1 credit and new accounts get 100 free credits, so you can check 100 hashtags before paying anything.
Can I pass a hashtag with #, without #, or as a URL?
All three work, and matching is case-insensitive. That helps when your list comes from a spreadsheet someone filled in by hand. Dedupe the list first, since #BookTok, booktok and the tag URL are the same lookup and each costs a credit.
Can I get historical TikTok hashtag stats?
Not from a single call. Each response is the current total. Store a daily snapshot and compute the differences yourself; the tracking script above does that.
Is there an official TikTok hashtag API?
Not for commercial use. TikTok's Research API can query videos by hashtag, but only for approved academic and not-for-profit researchers on a non-commercial basis. Creative Center shows trending hashtags in a web interface, not an API.
What happens if a request fails?
You get success: false with an HTTP status, an error code and a message. Blocks, timeouts and 5xx errors are refunded automatically, 400, 401, 402 and 429 errors are never charged, and a definitive 404 is charged like a normal lookup. Count fields can also be null when TikTok doesn't return them, so store them as nullable.
Start with the hashtags you already care about. Get 100 free credits, run the cURL command above against one of them, and schedule the snapshot script for tomorrow morning. Those 100 credits are 100 lookups, which is one day of a 100-tag tracker, so pick a smaller list for the trial or plan on a Builder pack for day two.
Scrape Everything returns public data only, never data from private accounts. We are not affiliated with TikTok.