TikTok Trending Hashtags Scraper — Rank, Views & Creators

Unofficial tool for publicly accessible TikTok Creative Center trend data. TikTok and related trademarks belong to their respective owners. Not affiliated with, sponsored by, or endorsed by TikTok or ByteDance. Provided for informational use only; users must comply with applicable terms and laws.

Social discovery	Product launches
TikTok Trending Hashtags Scraper ◄── you are here	Product Hunt Scraper
Bluesky Scraper	Launches, reviews, comments, leaderboards

TikTok trending hashtags scraper and TikTok API alternative — extract TikTok's own Creative Center ranking as structured JSON: hashtag, rank, video views, post count, industry labels, a popularity curve, and the top creators driving it. Filter by country and 7 / 30 / 90-day window. No TikTok login, no cookies, no API token.

Scrape TikTok hashtags with Python, Node.js, cURL, or MCP / AI assistants. Export JSON, CSV, or Excel from the dataset.

When to use

• See what is ranking on TikTok this week in a specific market
• Compare 7-day breakouts vs 90-day staying power
• Sweep all 27 published countries in one run
• Feed hashtag + creator handles into a briefing, dashboard, or agent workflow

When not to use

• You need more than 3 hashtags per country and window — that is TikTok's public cap (totalCount: 3, hasMore: false). There is no page 2.
• You want videos under a hashtag, comments, or profiles — this Actor only returns the Creative Center board.
• You send period=120 expecting a 120-day chart. TikTok silently serves 7 days on that value; this Actor remaps 120/180 to 90 instead.

Key features

• Official board, not a guess — Remix loaderData / dehydratedState from Creative Center Trends → Hashtag
• 27 countries — the exact hashtagCountry list TikTok publishes (US, GB, DE, BR, JP, …)
• 7 / 30 / 90-day windows — echoed period and countryCode written back on every row
• Curve + momentum — 7-point popularity series plus rising / fading / flat
• Top creators — handle, nickname, follower count, profile URL
• Honest empty-run — HTTP 200 under 200 bytes or a missing popular/hashtags query is treated as a fingerprint gate, not "no trends today"
• No login — residential proxy recommended on Apify

Input

Parameter	Description
countries	ISO codes to scrape (default US). Closed list of 27 markets
allCountries	Sweep every published market in one run
period	7, 30, or 90 (default 7)
periods	Extra windows merged with period (e.g. 7+30+90)
maxItems	Dataset cap for the whole run (default 100)
concurrency	Parallel slices, 1–12 (default 6)
proxyConfiguration	Apify RESIDENTIAL recommended

United States, this week:

{
  "countries": ["US"],
  "period": "7",
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

All 27 countries, three windows:

{
  "allCountries": true,
  "periods": ["7", "30", "90"],
  "maxItems": 250,
  "concurrency": 8
}

Output

One dataset row per hashtag × country × window. TikTok serves 3 rows per slice.

Field	Description
type	Always hashtag_trend
hashtagId / hashtagName	TikTok id and name without #
hashtagUrl	Tag page on tiktok.com
rank	Board position (1 = top)
country / countryName / period	Market and window TikTok actually served
countryRequested / periodRequested	What you asked for
countryFallbackApplied / periodAliasApplied	True when served ≠ requested
views / publishCount	Window video views and post count
industryIds / industryLabels	Creative Center industry classification
popularityCurve	[{ timestamp, value }] 0–100 series
momentum / trendDirection	Last-third vs first-third of the curve (rising / fading / flat)
topCreators	creatorId, handle, nickname, followerCount, avatarUrl, profileUrl
link / sourceUrl	Creative Center slice URL
scrapedAt	ISO timestamp

{
  "type": "hashtag_trend",
  "hashtagId": "497780",
  "hashtagName": "perezhilton",
  "hashtagUrl": "https://www.tiktok.com/tag/perezhilton",
  "rank": 1,
  "country": "US",
  "countryName": "United States",
  "period": 7,
  "publishCount": 11897,
  "views": 332625639,
  "industryLabels": ["News and Entertainment"],
  "trendDirection": "fading",
  "momentum": -76.21,
  "topCreators": [
    {
      "handle": "lvlyrxy",
      "nickname": "LVLYRXY",
      "followerCount": 3759,
      "profileUrl": "https://www.tiktok.com/@lvlyrxy"
    }
  ]
}

Use cases

• Weekly trend brief for a social team (US + GB + DE, 7-day window)
• Spot low-competition reach: high views, lower publishCount
• Catch fading vs rising tags from trendDirection before you brief creators
• Multi-market sweep: same hashtag appearing in many country rows is a cross-border signal
• Hand topCreators[].handle to a profile/enrichment workflow
• Give an AI assistant the board via MCP and ask for a one-page briefing

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/tiktok-trending-hashtags-scraper').call({
  countries: ['US'],
  period: '7',
  maxItems: 10,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient(token)
run = client.actor("crawloop/tiktok-trending-hashtags-scraper").call(
    run_input={"countries": ["US"], "period": "7", "maxItems": 10}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("rank"), item.get("hashtagName"), item.get("views"))

cURL

curl "https://api.apify.com/v2/acts/crawloop~tiktok-trending-hashtags-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"countries":["US"],"period":"7","maxItems":10}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call crawloop/tiktok-trending-hashtags-scraper.

Example prompts:

• "Run TikTok Trending Hashtags Scraper for US, 7-day window, and return rank, hashtag, views, and trendDirection"
• "Sweep GB, DE, and FR for 30-day TikTok trending hashtags and list rising tags"
• "Get all 27 countries for the 7-day TikTok hashtag board and summarize cross-market repeats, then check Bluesky mentions with Bluesky Scraper"

Suite next step

For open social listening on another network, run Bluesky Scraper (posts, search, monitor). For launch-day product buzz, use Product Hunt Scraper.

FAQ

Do I need a TikTok or ads account?
No. The Actor reads the public Creative Center trends board. Nothing to log into.

Is this a TikTok API?
It is a TikTok API alternative for the public trending-hashtag board — no official TikTok Research API key required.

Why only 3 hashtags?
That is TikTok's public payload: pagination.limit and totalCount are 3, hasMore is false. Sweep countries and windows for volume — 27 × 3 windows = up to 243 rows.

Can I scrape TikTok hashtags with Python or Node.js?
Yes. Use the Apify client examples above, or call the Actor from an AI assistant via MCP.

Why did a run fail with an empty dataset?
Creative Center is TLS-fingerprint gated. A plain HTTP client gets HTTP 200 and an empty dehydratedState. Enable Apify RESIDENTIAL proxy. This Actor fails the run instead of billing a silent empty board.

Is 120 days supported?
Not on this surface. Sending 120 to TikTok is aliased to 7. This Actor remaps 120/180 to 90 so you get the long window you likely wanted, and sets periodAliasApplied.

Can I get related hashtags or videos?
Not from this board route. Each row is the ranking + curve + creators TikTok puts on the Trends → Hashtag page.

Related Actors

Actor	Role
TikTok Trending Hashtags Scraper ◄── you are here	Creative Center hashtag ranking
Bluesky Scraper	Posts, profiles, search, monitor
Product Hunt Scraper	Product launches and reviews