Tiktok Trending Hashtags Analytics Scraper With Trend Creators avatar

Tiktok Trending Hashtags Analytics Scraper With Trend Creators

Pricing

Pay per usage

Go to Apify Store
Tiktok Trending Hashtags Analytics Scraper With Trend Creators

Tiktok Trending Hashtags Analytics Scraper With Trend Creators

TikTok Trending Hashtags Analytics Scraper tracks rising TikTok hashtags and extracts metrics like popularity, usage volume, top videos, creators, sounds, and engagement trends. Perfect for discovering viral topics, planning content, analyzing trends, and automating TikTok hashtag insights

Pricing

Pay per usage

Rating

0.0

(0)

Developer

SimpleAPI

SimpleAPI

Maintained by Community

Actor stats

0

Bookmarked

5

Total users

1

Monthly active users

3 days ago

Last modified

Share

TikTok Trending Hashtags Analytics Scraper With Trend Creators pulls TikTok's live trending-hashtag board for a country and window, then opens the exact creators TikTok itself names behind every trend into full public profiles — follower count, total likes, lifetime video count, verified badge, bio, and recent clips with real play counts. It's built for influencer and partnership teams who want the actual people driving a trend rather than just the trend name, brand and agency teams sizing a trend's real reach through its named creators' combined following, and researchers who need honest disclosure of every platform limit rather than a scraper that quietly papers over them. No login is required. Every section below documents an input, an output field, or one of the platform limits this Actor discloses transparently.

This Actor is a strict superset of a classic TikTok trending-hashtags analytics scraper: every classic input key still works with the same accepted values, and every classic output key is still emitted with the same value — with a full creator-enrichment layer added on top, opening the exact creators TikTok's own trending board names for each hashtag.

Key capabilities, read from the source:

  • Real creator profiles, not just names. include_creator_profiles opens each board-named creator's public profile embed for verified, privateAccount, followingCount, heartCount, bio, avatarUrl, and recent clips — the trending board itself only names a handle, nickname, rank, and exact follower count.
  • Two follower-count sources, both kept and labeled. The board's own followedCnt is exact (non-round on nearly every creator), while the public profile embed rounds anything above 10,000 — followerCount prefers the exact board number when available, followerCountSource discloses which was used, and profileFollowerCount keeps the rounded profile reading visible alongside it.
  • Lifetime video count resolved from an unusual source. TikTok's profile embed carries no video count at all (measured 0/36 profiles) — the only reachable source is the authorStats block on one of the creator's own clips, fetched via a per-creator probe, with a handle cross-check that drops the value rather than mis-attributing it if the match ever fails.
  • Honest disclosure of every ignored or aliased parameter. country: "ALL" and unsupported country codes are served as US data with countryFallbackApplied: true; top100_period: 120 is silently aliased to 7 days by TikTok with periodAliasApplied: true; top100_new_on_board is accepted but genuinely ignored by TikTok (4 parameter spellings tested, identical rows) with newOnBoardIgnored: true — nothing is fabricated to look like it worked.
  • Optional roster expansion beyond TikTok's 3 named creators. expand_creators_from_tag_videos adds the authors of a hashtag's top public videos once the board's 3 named creators are used up — measured yield of 4-8 additional unique authors per hashtag — tagged source: "tag_video_author" so they're never confused with TikTok's own picks.
  • 32-bit counter unwrapping. to_int() undoes TikTok's negative 32-bit wraparound on huge counters — the source notes a real measured case where @fifaworldcup's heart count arrived as -1254936319 and correctly unwraps to 3040030977.

Every field below is read directly from assemble(), enrich_creator_row(), and creator_rollup() in the source — the dataset's default view surfaces 27 of these, with a classic view preserving the base contract exactly.

Hashtag row fields

FieldExample ValueNotes
hashtag_name / hashtag_id / rank"summerfashion" / "12345" / 2Classic contract fields, unchanged
video_views / publish_cntwindow totalsClassic fields
dailyTrend / trendDirectiondaily curve / "rising"
industryNames / industryIdsUnmappedmapped labels / raw unmapped IDs
countryFallbackApplied / periodAliasApplied / newOnBoardIgnoredbooleansHonest platform-limit disclosure

Creator rollup fields (per hashtag row)

FieldExample ValueNotes
creatorCount / creatorsEnriched3 / 3
creatorFollowersTotal / creatorFollowersMedian / creatorFollowersMaxcombined reach stats
verifiedCreatorCount / creatorTierMix1 / {"nano":0,"micro":1,"mid":1,"mega":1}
topCreatorHandle / topCreatorFollowers / topCreatorVerifiedthe board's #1-ranked creator

Individual creator fields (nested in creators[], also flattened to the trend-creators child dataset)

FieldExample ValueNotes
handle / nickname / profileUrlcreator identity
followerCount / followerCountSource / profileFollowerCount2400000 / "trending_board" / 2380000Both real numbers, source disclosed
heartCount / likesPerFollowertotal likes / derived ratio
videoCount / videoCountSourcelifetime video count / "video_embed_author_stats"null when unresolvable
verified / privateAccount / bioaccount status + bio
creatorTier"mid"nano/micro/mid/mega by follower band
recentVideosarray of {videoId, videoUrl, caption, playCount, coverUrl}
source"board" or "tag_video_author"Whether TikTok named this creator or the Actor discovered them

Why not build this yourself?

TikTok's trending-hashtag board is TLS/JA3-gated — the module docstring notes a Node/Playwright HTTP stack gets served a 49-byte empty payload while curl_cffi with Chrome impersonation gets the real ~7KB payload, so getting past this requires knowing which transport actually works, not just retrying the same one. Reaching the creators behind a trend is harder still: the board names exactly 3 creators with only a handle and exact follower count, and every other field (verification, bio, lifetime video count) requires a separate embed fetch per creator — with video count specifically requiring probing one of the creator's own clips, since it doesn't exist anywhere on the profile embed itself (measured 0/36). Getting these numbers wrong in either direction — inventing a "Top 100" TikTok doesn't serve, or silently substituting US data for an unsupported country without saying so — is exactly the kind of quiet failure this Actor's extensive disclosure fields exist to prevent.

Influencer and partnership discovery

Run a target country/window with include_creator_profiles on and creator_tier_in scoped to your budget tier (e.g. micro/mid) to get a shortlist of creators actively driving trends, with real follower counts and recent-clip performance attached.

Brand and agency trend sizing

Use creatorFollowersTotal and creatorFollowersMedian per hashtag to gauge a trend's real combined reach through its named creators, rather than relying on the hashtag's raw view count alone.

Market and industry research

Scope a run with top100_industry to a relevant category and compare trendDirection across hashtags to see which trends in your industry are genuinely rising versus fading.

AI agents and creator-sourcing pipelines

Because every honesty flag (countryFallbackApplied, periodAliasApplied, countsArePrecise) is explicit, an agent can filter for only fully-verified, non-aliased rows before feeding creator data into a sourcing or outreach model.

🔼 Input sample

ParameterRequiredTypeDescriptionExample Value
result_typeNostring enumtop100, top100_with_analytics, or analytics (custom list). Default "top100_with_analytics"."top100_with_analytics"
countryNostring enum27 real country boards; unsupported values served as US with countryFallbackApplied: true. Default "US"."JP"
top100_periodNostring enum"7", "30", "90" real; "120" aliased to 7 with disclosure. Default "7"."90"
top100_industryNostring enumClient-side industry filter; 9 of 20 labels are ID-mapped."Travel"
hashtag_listNoarrayCustom hashtag names for analytics result type.["summerfashion"]
total_hashtagsNointeger (1–500)Upper bound; TikTok's board hard-caps at 3 per country+window regardless. Default 10.10
include_creator_profilesNobooleanOpen each creator's full public profile. Default true.true
creators_per_hashtagNointeger (1–12)Ceiling is 3 unless expand_creators_from_tag_videos is on. Default 3.3
expand_creators_from_tag_videosNobooleanAdd tag-video authors beyond the board's 3 named creators. Default false.false
include_creator_recent_videosNobooleanAttach each creator's recent clips. Default true.true
fetch_creator_video_countNobooleanResolve lifetime video count via a clip probe. Default true.true
min_creator_followers / max_creator_followersNointegerPost-fetch follower-count filter.10000
verified_onlyNobooleanKeep only verified creators. Default false.false
creator_tier_inNoarraynano/micro/mid/mega. Empty = all tiers.["micro", "mid"]
creator_concurrencyNointeger (1–16)Parallel profile/clip requests. Default 8.8
creator_child_datasetNobooleanAlso write a flat creator dataset (trend-creators). Default true.true
analytics_period, top100_new_on_boardNovariousAccepted for compatibility; genuinely ignored upstream, echoed with an *Ignored: true flag.
proxyConfigurationNoobjectEvery surface works with no proxy; kept as an escalation tier only.{"useApifyProxy": true}
{
"country": "US",
"top100_period": "7",
"include_creator_profiles": true,
"creator_tier_in": ["micro", "mid"]
}

Common pitfall: total_hashtags above 3 doesn't get you more hashtags per run — TikTok's board hard-caps at exactly 3 rows per country+window combination and ignores every paging parameter. Breadth comes from running more country/window combinations, not a higher total_hashtags.

🔽 Output sample

Output is one JSON row per hashtag (with creators nested inside), plus one flat row per creator to the trend-creators child dataset when creator_child_dataset is on.

{
"hashtag_name": "summerfashion",
"rank": 2,
"regionCode": "US",
"periodDays": 7,
"video_views": "188.7M",
"creatorCount": 3,
"creatorFollowersTotal": 4500000,
"creatorFollowersMedian": 1200000,
"verifiedCreatorCount": 1,
"topCreatorHandle": "examplecreator",
"topCreatorFollowers": 2400000,
"topCreatorVerified": true,
"creators": [
{
"handle": "examplecreator",
"followerCount": 2400000,
"followerCountSource": "trending_board",
"profileFollowerCount": 2380000,
"verified": true,
"videoCount": 842,
"videoCountSource": "video_embed_author_stats",
"creatorTier": "mid",
"source": "board"
}
],
"countryFallbackApplied": false,
"periodAliasApplied": false
}

How do you filter and target specific hashtags and creators?

Tier filtering targets budget-appropriate creators. creator_tier_in: ["micro", "mid"] finds reachable creators worth partnering with rather than celebrities you likely can't afford — the measured board mix (178 nano, 229 micro, 174 mid, 148 mega across 729 creators) shows most named creators aren't mega accounts.

Industry filter narrows to your category. top100_industry is applied client-side against TikTok's own industry IDs — only 9 of the 20 schema labels are currently ID-mapped, and an unmapped label logs a warning and keeps every row rather than silently returning nothing.

Expand the roster only when you need more than 3. expand_creators_from_tag_videos is the only way past TikTok's own 3-named-creators limit — leave it off for a faster run when 3 creators per hashtag is enough.

Three real examples:

{ "country": "US", "top100_period": "7", "creator_tier_in": ["micro"], "min_creator_followers": 10000 }

Reachable micro-influencer discovery for US trends this week.

{ "result_type": "analytics", "hashtag_list": ["summerfashion"], "expand_creators_from_tag_videos": true, "creators_per_hashtag": 8 }

Deep single-hashtag creator roster, expanded past the board's 3 names.

{ "country": "JP", "top100_period": "30", "top100_industry": "Beauty & Personal Care" }

Category-scoped 30-day trend scan for the Japan market.

▶️ Want to try other scrapers?

ScraperWhat it extracts
TikTok Trending Hashtags Scraper — Daily Growth HistoryDecoded daily popularity sparkline
TikTok Video Scraper — Hashtag, Sound & ReachVideo-level reach and sound data
TikTok Profile Scraper — Engagement Rate & Posting CadenceCreator engagement and cadence metrics
Instagram Outreach Lead ScorerProfiles scored for outreach fit

This Actor runs as a standard Apify Actor call — one API call in, structured JSON dataset out, using your Apify API token.

Python example

from apify_client import ApifyClient
client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("<YOUR_USERNAME>/tiktok-trending-hashtags-trend-creators").call(run_input={
"country": "US",
"top100_period": "7",
"creator_tier_in": ["micro", "mid"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item["hashtag_name"], item["topCreatorHandle"], item["creatorFollowersTotal"])

Export to spreadsheets or CRM

Every dataset supports one-click CSV/Excel export from the Apify Console. Use the trend-creators child dataset for a flat, CSV-ready creator list without needing to un-nest the creators array yourself.

Scraping TikTok's publicly visible trending-hashtag board and public creator profiles is generally lawful, since this data is published for anyone to view without logging in — the underlying legal question was tested directly in hiQ Labs v. LinkedIn (9th Cir.), which held that scraping public, non-password-protected data does not violate the U.S. Computer Fraud and Abuse Act. Creator handles, bios, and follower counts are personal data under GDPR/CCPA when tied to an identifiable individual, so treat that subset accordingly if you store or reuse it at scale, and consult legal counsel for commercial applications, particularly influencer outreach.

❓ FAQ

Why do two different follower counts appear on a creator row?

followerCount is the number actually used (preferring the board's exact followedCnt when available), followerCountSource says which source it came from, and profileFollowerCount keeps the profile embed's own reading — which rounds anything above 10,000 — visible for comparison.

Can I get more than the 3 creators TikTok names per hashtag?

Only via expand_creators_from_tag_videos, which adds the authors of the hashtag's top public videos once TikTok's 3 named creators are exhausted — measured yield of 4-8 additional unique authors per hashtag. These are tagged source: "tag_video_author", distinct from TikTok's own board picks.

Why is videoCount sometimes null even with fetch_creator_video_count on?

It's only resolvable when the creator has at least one clip TikTok's profile embed exposes to probe — a creator with zero visible clips can't have their lifetime video count resolved this way, and the field stays honestly null rather than being guessed.

What happens if I request an unsupported country?

It's served as the US board, and every row on that hashtag is flagged countryFallbackApplied: true and countrySupported: false — the Actor never relabels US data as if it were the country you requested.

No — TikTok itself ignores this parameter on the public trends surface (tested across 4 parameter spellings, identical results) and publishes no rank-change marker at all. The field is accepted for compatibility and every row carries newOnBoardIgnored: true rather than a fabricated "new" flag.

As observed on the Apify Store on 2026-07-26, codebyte/tiktok-trending-hashtags-analytics and api-empire/tiktok-trending-hashtags-analytics-scraper both extract trending hashtag analytics, but neither documents opening the board's named creators into full enriched profiles — that creator layer, with dual follower-count sourcing and lifetime video-count resolution, is unique to this Actor.

Does this work with AI agent frameworks?

Yes — call it as a standard HTTP endpoint via the Apify API from any agent framework capable of making an API call; there's no MCP-specific integration for this Actor.

Conclusion

TikTok Trending Hashtags Analytics Scraper With Trend Creators turns a trending-hashtag board into the real creators behind each trend — full public profiles, dual-sourced follower counts, and lifetime video counts resolved from an otherwise-unreachable source, with every platform limit disclosed rather than hidden. It fits influencer discovery, trend sizing, and market research that needs the people, not just the hashtag name. Start a run from the Apify Console or the Apify API with your target country to get your first trend-and-creators export.