Google Ads Transparency Scraper

A scraper for Google Ads Transparency Center. Extract ad creatives, advertiser info, and creative details from adstransparency.google.com.

ℹ️ This scrapes public Google Ads Transparency data — no authentication required. Optional cookies can be provided for personalized results.

Features

• Domain Search: Find all ads running on a specific domain (e.g. facebook.com).
• Advertiser Search: Look up ads by advertiser name (auto-resolves via SearchSuggestions API).
• Details Mode: Fetch full creative details — ad variants, targeting countries, and text content. Runs in batches of 5 for speed.
• Image Downloads: Optionally download preview images to the Apify key-value store (separate from details mode).
• Date Filtering: Filter by preset ranges (7/30/90 days) or custom YYYYMMDD range.
• Region Scoping: Scope results to any of 240+ supported countries.
• Pagination: Automatically pages through results up to your configured limit.
• Total Estimates: Returns lower/upper bound of total ads matching your query.
• Rate Limiting: Built-in delays between queries (1.5s), pagination (500ms), and detail batches (300ms).

Input Parameters

Parameter	Type	Description
query	String	Domain(s) or advertiser name(s) to search (comma-separated or new lines). Max 5 per run.
searchType	String	domain (default) or advertiser.
region	String	Country code (e.g. US, DE, CA). Default: anywhere.
dateRange	String	any (default), last7, last30, last90, or custom.
startDate	String	Custom start date YYYYMMDD (only with dateRange=custom).
endDate	String	Custom end date YYYYMMDD (only with dateRange=custom).
maxResults	Integer	Max ads to return per query. Default: 40, max: 10000.
details	Boolean	Fetch full creative details per ad. Default: false.
downloadImages	Boolean	Download preview images to KV store (requires details=true). Default: false.
cookies	String	Optional browser cookie string for personalized/authenticated requests.
proxy	Object	Proxy configuration.

Output

Data is stored in the default dataset in JSON format. Images (when enabled) are stored in the default key-value store.

Example: Domain Search (details=false)

{
  "id": "CR05264906572273811457",
  "advertiserId": "AR01247602649897893889",
  "creativeId": "CR05264906572273811457",
  "advertiserName": "NBC Universal, Inc.",
  "format": "TEXT",
  "url": "https://adstransparency.google.com/advertiser/AR.../creative/CR...?region=anywhere",
  "previewUrl": "https://tpc.googlesyndication.com/archive/simgad/...",
  "previewStoreKey": null,
  "impressions": null,
  "shownCountries": [],
  "countryStats": [],
  "audienceSelections": [],
  "variants": [],
  "originUrl": "https://adstransparency.google.com/advertiser/AR...?region=anywhere",
  "domain": "facebook.com",
  "total_days_shown": 3,
  "verified": false,
  "searchQuery": "facebook.com",
  "totalEstimateLower": "300000",
  "totalEstimateUpper": "400000"
}

Example: With Details (details=true, downloadImages=false)

{
  "id": "CR13978511766854828033",
  "advertiserName": "Chi nhánh công ty TNHH...",
  "format": "TEXT",
  "previewUrl": "https://tpc.googlesyndication.com/archive/simgad/...",
  "previewStoreKey": null,
  "shownCountries": ["Vietnam"],
  "variants": [
    {
      "textContent": "Ad headline text",
      "images": ["https://tpc.googlesyndication.com/..."],
      "imageStoreKeys": []
    }
  ],
  "verified": false,
  "totalEstimateLower": "300000",
  "totalEstimateUpper": "400000"
}

Key-Value Store (Images)

When downloadImages=true, preview images are downloaded and stored:

Key Format	Content
{creativeId}_preview_0.jpg	Preview image (JPEG)

Access stored images via the Apify API or console after the run completes.