Keep readable reach, impression and target-audience buckets while adding integer lower/upper counts at every level. Preserve the source's millisecond shown-date timestamps alongside UTC dates. Accept all in regions to expand all 33 supported regions. Earlier export baselines remain usable without false changes from the added convenience fields.
Explicit blank keywords and advertiser names preserve the source's separate browse modes. Omitted work inputs remain empty.
Add optional list-only exports with fetchDetails false. Named cards must match the requested advertiser; supplied business IDs force details, as do direct URLs. Basic/detail baseline mismatches are refused.
Export TikTok Commercial Content Library ads in its 33 offered regions by keyword, exact advertiser name with an optional matching business ID, Library search URL or direct ad URL. Filter video/image/text ads and include advertiser identity, payer/profile, shown dates, reach and impression ranges, targeting, demographic buckets, creative media, CTA and ad text. Compare a read-only full export baseline for new and changed ads; infer ended only after a complete stable query read. Use rotating datacenter sessions. Errors and empty queries go to run records, and a binding charge limit stops further reads.
Search URLs inherit each omitted date input and preserve their explicit date boundaries. COVERAGE records effective search windows and partial unresolved-advertiser queries; an unchanged monitor run reports that no changes matched.
Change detection excludes lastShown, derived flight-day and profile follower-count drift while retaining their current values on delivered snapshots.