# Changelog of TikTok Ads Scraper (`data_xplorer/tiktok-ads-scraper`) Actor

- **URL**: https://apify.com/data\_xplorer/tiktok-ads-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/data\_xplorer/tiktok-ads-scraper.md

## Changelog

### 2026-09-17 / v3.6

- 🔧 **Proxy configuration removed from the input**: IP rotation is now handled internally on a more reliable network, no setup needed
- 🔁 **Smarter session rotation**: each IP handles one wave of detail requests then gets retired early, instead of being used until TikTok refuses it. Roughly halved detail requests per ad and nearly eliminated the final retry pass
- ⚡ **Detail concurrency doubled**

### 2026-09-09 / v3.5

- ⚡ **Library mode rewritten to drop the browser entirely**: faster, more reliable ad collection with fewer failed runs

### 2026-08-31 / v3.4

- 🔧 **TikTok API breaking change**: adapted to TikTok's August 2026 anti-bot overhaul

- 🔢 **Numeric ranges now parsed to integers**: `Ad Audience`, `Ad Target Audience Size` and every `Ad Reach` impressions value are now returned as `{ raw, min, max }` (e.g. `{ "raw": "11.7M-14.2M", "min": 11700000, "max": 14200000 }`), keep the readable text in `raw`, sort/filter/aggregate on `min` / `max`

### 2026-06-22 / v3.2

- 🗺️ **Per-country reach now extracted** (Library mode, with Fetch Ad Details): new `Ad Reach` field with total impressions and, for each country, the exact reach **plus a full age × gender breakdown** , the reliable "Reach by location" figure, far more accurate than the broad "Unique users seen" estimate
- 👤 **New `Advertiser` field**: advertiser profile including business IDs, registry location, sponsor, and linked TikTok account (username, display name, follower count, account type, profile link)
- 🏷️ **New `Ad Title` field** and enriched `Ad Details` (advertising objective, call to action, external landing URL)
- 🎯 Richer `Ad Targeting` (languages, cities, provinces, operating systems, high spending power, audience signals)

### 2026-06-14 / v3.1

- ⚡ Much faster & more reliable ad collection: the ad list is now delivered at full speed and is no longer held back by ad-detail fetching

### 2026-06-08 / v3.0.0

- 🎯 **New mode: Top Ads**, scrape top-performing ads from TikTok Creative Center with engagement metrics, budget insights, and industry classification
- 🔍 Keyword search for Top Ads (Find ads by brand, product, or topic)
- 🌍 80+ countries supported in Top Ads mode with multi-select filtering
- 🏷️ 200+ industries & sub-industries filter with hierarchical selection
- 🎯 Campaign objective filtering (Traffic, Conversions, App Installs, and more)

### 2026-06-03 / v2.9.0

- 🔧 Fixed exact match keyword search returning no results

### 2026-05-29 / v2.8.0

- 🛡️ Adapted to TikTok's latest anti-bot protections

### 2026-05-25 / v2.7.0

- 🔧 Fixed timestamp precision: URL mode now preserves exact timestamps from TikTok URLs instead of truncating to midnight
- 🕐 Fixed manual date mode
- 🏷️ Separated Advertiser Name and Advertiser ID into distinct input fields — TikTok now requires the advertiser name, ID is optional
- 📥 New optional `advertiserBizId` input field for precise advertiser filtering (found in TikTok URL as `adv_biz_ids`)
- 🔗 Updated URL parser to correctly extract `adv_name` and `adv_biz_ids` as separate fields
- ⚠️ Added warning when only an Advertiser ID is provided without a name (may return incomplete results)

### 2026-03-11 / v0.3

- 🐛 Fixed silent stop when API returns non-zero code
- 🐛 Fixed pages appearing "skipped" due to silent duplicate filtering — now logs `♻️ Skipped X duplicate ad(s)`
- 🛑 Added stagnation detection: stops after 5 consecutive pages with no new ads to avoid infinite loops

### 2026-02-25 / v0.2

- 🐛 Fixed display URL generation for all search modes
- ⚡ Reduced inter-page delay

### 2026-02-14 / v0.1

- 🤖 Fork 'Tik Tok Ads Library FAST' for compatibility with Pay Per Event