# Changelog of Google Ads Transparency Scraper — Competitor Ad Library (`aaronoptimus/google-ads-transparency-scraper`) Actor

- **URL**: https://apify.com/aaronoptimus/google-ads-transparency-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/aaronoptimus/google-ads-transparency-scraper.md

## Changelog

### 1.0 (2026-10-06)

- First release: ads and advertisers from the Google Ads Transparency Center by advertiser name, website domain, advertiser ID or pasted Transparency Center link.
- Filters: region (any country or anywhere), ad format, shown-between dates or "shown in the last N days".
- Google Ads ids per ad (customer, ad group, creative) from the preview link, where Google includes them.
- Name search picks the matching advertiser accounts (exact matches first, look-alike names never used).
- Ad details (optional): countries shown with first/last shown per country, variations, YouTube video of video ads, landing page.
- Only new ads: monitoring memory in a named key-value store; scheduled runs return and charge only ads not delivered before.
- Each ad is delivered and charged once per run, even when several searches find it.
- Pay per event (run start, ad, ad details, advertiser); progress saved before every charge; maximum cost per run respected across parallel searches; resumes after migrations without double charges.
- Refused requests (429, "unusual traffic") are retried from new proxy sessions with growing pauses and an automatic residential fallback; CAPTCHAs are never solved.
- Near the run's timeout, retries stop early so the run always saves its `OUTPUT` summary.
- Advertisers mode: each advertiser is delivered and charged once per run, also with parallel searches.
- With a region, advertiser rows from a name search keep only accounts that have ads in that country.
- If Google's answer format changes, searches fail with a clear message (free) instead of returning an empty success.
- Detail lookups stop after Google refuses them for 3 ads in a row; ads keep coming without details.
- "Dr.Oetker"-style brand names are searched as names, not domains. Single-ad links look through at most 5,000 ads.
- README: individuals among advertisers, look-through limit, timeout guidance, FAQ, per-1,000 prices.
- From the first live run: Ad details now read the ad's text (headline, description, display URL, business name) and Shopping product title and image from Google's preview; countries shown are country codes (Google publishes no per-country dates); image ads get an image from their preview; the unreliable "verified" field is removed.
- Ad text: HTML entities such as & are decoded.
- Launch listing: title "Competitor Ad Library", tiered prices by Apify plan (ads from $1.20 per 1,000), README rebuilt around our own live sample, main markets first in the region list, billing helper that plans budgets with tiered prices.