This changelog highlights releases that materially changed TikTok Trends Scraper for users. Dates use UTC; small internal refactors and routine maintenance are intentionally omitted.
Fixes
- Hashtag runs now return about 45 hashtags per country and period instead of 3. TikTok started showing logged-out visitors 3 hashtags per list, so the Actor now reads the overall list and 15 industry lists and merges them.
rank is the position in the run; rankingScope, isFormalRanking and the new listRank and listIndustry show which rows are TikTok's own ranks.
- Explore runs now reach the requested count, usually up to 100, instead of stopping at about 20–30.
- A
period Creative Center does not serve, such as 120, now uses its closest window (90) instead of returning rows derived from Explore.
- Unknown metrics are now empty instead of
0 on video and hashtag rows.
- Non-Latin hashtags are now included in a video's
hashtags.
- A run restarted by a platform migration no longer pays the start fee twice.
- If saving or charging a result fails, the run now fails and says so, keeps the rows it saved, and does not charge for a row that was not saved. A start fee charge that fails or cannot be confirmed now stops the run before it collects any data.
- A spending limit below the start fee now ends the run with no charge.
- Runs stop at your spending limit without writing rows past it, and every run ends with a status saying how many results you got and why.
Pricing
- From 2026-11-21, Creative Center rows cost $0.002 on BRONZE with no start fee, and Explore rows cost $0.0062 on BRONZE with the $0.05 start fee. See the README for all plans.
Features
- Ranked Creative Center top videos with
videoSource: "creativeCenter" for US, JP, VN, TH and ID, by views, engagement or 6-second view rate, with an organic-only option.
- Hashtag rows gain
popularityCurve, trendStage, momentumPct, peakDate, industries, topCreators, hashtagId and hashtagUrl. An industry input reads one industry's list.
- Explore rows gain creator follower, like and video totals, bio, profile link and verified status; video saves, duration, post date and author followers; sound commercial-use flag and example video.
Fixes
- Country codes TikTok does not serve (Hong Kong
HK, mainland China CN, India IN) and malformed codes are now rejected at input validation, instead of starting a run, charging the start fee and failing after a minute of empty browser retries. The README no longer lists India as supported, and it no longer suggests an empty country code: omit countryCode to use US.
Reliability
- Collected trends now survive platform migration before output begins, instead of being lost when the request queue resumes after a server restart. Interrupted output batches fail clearly without replaying existing rows.
Reliability
- Late Explore records now enrich matching page/search videos instead of being discarded, preserving available sounds, creator IDs, and engagement metrics without duplicate videos.
- Public TikTok fallback pages now initialize API response capture, browser setup, and resource controls before manual navigation, and retain feed records that arrive during search. Creator, sound, and video collection can use the Explore feed instead of missing it.
Reliability
- Creator, sound, and video modes now apply their bounded fresh-session retry after TikTok navigation failures, instead of ending after the first browser identity.
Reliability
- Video mode now opens TikTok's bounded Explore/DOM/search route ladder before evaluating results, preventing valid video requests from failing after waiting on an unvisited page.
Features
- Every result now includes
source, rankingScope, and isFormalRanking, making formal Creative Center hashtag rankings machine-distinguishable from TikTok Explore source order.
Reliability
- Creator, sound, and video fallbacks now retry once with a fresh browser and proxy session when one TikTok identity returns empty pages from every public source.
Performance
- Explore modes now query public JSON before loading alternate pages, avoiding repeated page transfers on the common successful path while preserving fallback coverage.
Reliability
- Creator, sound, and video fallbacks now recover from a slow TikTok Explore document by retaining captured API data and trying alternate public routes instead of failing during initial navigation.
Fixes
- Video URLs are now visible as clickable links in the default dataset overview.
Reliability
- Hashtag fallback now runs after an empty Creative Center response instead of being skipped by a shared request limit.
- Creator and sound fallback searches now collect enough distinct entities rather than stopping at the requested number of raw videos.
Reliability
- Creator, sound, and video trend runs now continue capturing TikTok Explore data when the page keeps loading beyond the initial navigation window, with additional browser memory headroom for heavier feeds.
Reliability
- Reduced sound and creator trend latency and blocked-run retries by bypassing legacy TikTok endpoints that no longer return results.
- Low-volume Explore runs now stop background page traffic as soon as enough distinct results are available.
Fixes
- Sound and creator fields that TikTok does not provide are now omitted instead of being reported as measured zeroes. Explore-derived output is also documented as discovery-source order rather than a formal regional ranking.
Fixes
- Restored video trend results by capturing concrete ranked items from TikTok's current Explore data feed instead of relying on delayed page cards and search fallbacks.
Safety
- Removed synthetic fallback trend rows. Runs now return only concrete TikTok records and fail clearly when no live source yields data.
Fixes
- Migrated hashtag extraction to TikTok Creative Center's current public trends API.
Features
- Added public Store task examples so users can start common TikTok trend scraping workflows faster.
Reliability
- Capped fallback latency so larger trend runs are less likely to time out when TikTok blocks live trend APIs.
Reliability
- Improved public fallback reliability for creator, hashtag, sound, and video trend searches when Creative Center returns no items.
Changes
- Added safer result caps and clearer progress logs for long trend scraping runs.
Reliability
- Hardened fallback navigation when TikTok Creative Center returns empty or blocked responses.
Reliability
- Added a public TikTok fallback path so trend searches can still return discovery results when Creative Center blocks trend data.
Fixes
- Fixed video trend runs that could return hashtag-style items instead of video trend results.
Fixes
- Reduced timeout regressions in trend runs by tightening runtime behavior.
Features
- Initial release for scraping TikTok Creative Center trend data, including hashtags, sounds, creators, and videos with engagement metrics, view counts, growth rates, and rankings.