# Changelog of TikTok Trends Scraper (`automation-lab/tiktok-trends-scraper`) Actor

- **URL**: https://apify.com/automation-lab/tiktok-trends-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/automation-lab/tiktok-trends-scraper.md

## Changelog

This changelog highlights releases that materially changed TikTok Trends Scraper for users. Dates use UTC; small internal refactors and routine maintenance are intentionally omitted.

### 2026-09-19

*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.

### 2026-09-15

*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.

### 2026-09-05

*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.

### 2026-09-01

*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.

### 2026-08-15

*Fixes*

- Video URLs are now visible as clickable links in the default dataset overview.

### 2026-08-14

*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.

### 2026-08-07

*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.

### 2026-08-01

*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.

### 2026-07-29

*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.

### 2026-07-28

*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.

### 2026-06-19

*Features*

- Added public Store task examples so users can start common TikTok trend scraping workflows faster.

### 2026-06-16

*Reliability*

- Capped fallback latency so larger trend runs are less likely to time out when TikTok blocks live trend APIs.

### 2026-06-15

*Reliability*

- Improved public fallback reliability for creator, hashtag, sound, and video trend searches when Creative Center returns no items.

### 2026-06-14

*Changes*

- Added safer result caps and clearer progress logs for long trend scraping runs.

### 2026-05-24

*Reliability*

- Hardened fallback navigation when TikTok Creative Center returns empty or blocked responses.

### 2026-05-20

*Reliability*

- Added a public TikTok fallback path so trend searches can still return discovery results when Creative Center blocks trend data.

### 2026-04-28

*Fixes*

- Fixed video trend runs that could return hashtag-style items instead of video trend results.

### 2026-04-20

*Fixes*

- Reduced timeout regressions in trend runs by tightening runtime behavior.

### 2026-04-02

*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.