# Changelog of TikTok Ads Library API | EU Ads, Ad Targeting, $1.40/1K (`aurelix/tiktok-ads-library-scraper`) Actor

- **URL**: https://apify.com/aurelix/tiktok-ads-library-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/aurelix/tiktok-ads-library-scraper.md

## Changelog: TikTok Ads Library API

### 0.2

- Country 'All covered countries' is back; one ad's id or detail-page URL works as a query; common input names (query, advertiserName, adIds, region, maxAds, maxPages, startDate, fetchDetails) are understood; the 'Publication date' sort returns ads again; a cut-short first results page is retried in a fresh session; a run where TikTok does not answer ends with a plain message and no ads charged; bad input ends the run with the reason instead of failing it; a short run timeout stops in time and keeps what was saved.
- Advertisers that are people are no longer dropped; the linked TikTok account is returned for every account type, with new fields tiktok_account_display_name, tiktok_account_type and tiktok_account_url.

### 0.1

- Stricter private-person filter: advertisers named with 2-3 plain capitalised words and no business word are dropped before charging.
- Start fee stated as charged: $0.02 per GB, $0.04 per run at the default 2 GB. Optional Slack/webhook digest after each run.
- App ads return their app-store link as landing_url. Store page corrected: it no longer says every ad has a landing page.
- A query is marked PARTIAL when TikTok ends its list before your limit.
- One price per ad, with or without the targeting summary: $1.40 per 1,000 ads on every plan. The residential and datacenter proxy options were removed.
- Faster, cheaper runs: TikTok's page scripts load once per run, runs connect without a proxy, and login, analytics and monitoring scripts are skipped.
- Each query now takes only its own search results for its country and dates; the all-countries option was removed.
- TikTok pages that refuse a request are retried, and detail pages load in their own session, so a refused detail page no longer stalls the search.
- First release: keyword, advertiser and URL search; targeting summary; private-person advertisers excluded; exact limits; incremental mode.