Google Ads Transparency Scraper — Fast, Reliable, Watch Mode
Pricing
from $1.00 / 1,000 ad scraped (1 result)s
Get an advertiser's Google ads by domain, advertiser ID, or Transparency Center URL. Returns creative images, OCR'd headline/body text, format, and shown dates. Watch mode returns only new ads.
advertiserId
Required
Google's advertiser id, e.g. AR18378488041124659201.
creativeId
Required
Google's id for this specific ad.
advertiserName
Optional
Advertiser display name as shown in the Transparency Center.
legalName
Optional
Verified legal name. Present when Resolve advertiser info is on.
advertiserCountry
Optional
Advertiser's verified country, ISO alpha-2. Present when Resolve advertiser info is on.
format
Optional
Creative format: TEXT, IMAGE, or VIDEO. A format code Google returns that this Actor does not yet name comes through as "FORMAT_" instead — see formatCode for the raw value.
formatCode
Optional
Google's raw numeric format enum behind the format field.
firstShownAt
Optional
When this creative was first shown.
lastShownAt
Optional
When this creative was last shown; refreshes continuously while the ad is still running.
previewImageUrl
Optional
One representative image URL for this creative, used as the dataset thumbnail.
previewImageUrls
Optional
This creative's own image URLs, hosted on Google (never advertiser-controlled hosts).
externalImageUrls
Optional
Advertiser-supplied image URLs on non-Google hosts. Never fetched by this Actor — treat as untrusted.
previewRenderUrls
Optional
Renderer endpoints for image/video/rich creatives with no direct image URL.
previewHtml
Optional
Raw advertiser-written preview markup. Untrusted — do not inject unsanitised.
youtubeVideoId
Optional
For video ads: the YouTube video id. Present when Archive creative images is on, until this run's asset-downloaded spending limit (if any) is reached.
youtubeUrl
Optional
youtube.com/watch URL built from youtubeVideoId.
storedAssetUrls
Optional
This run's own copies of the creative images, kept in the key-value store. Present when Archive creative images is on, until this run's asset-downloaded spending limit (if any) is reached.
transparencyUrl
Required
Deep link to this ad's page on the Google Ads Transparency Center.
creativeText
Optional
The words in the creative, read out of the image by OCR. Present when Read the ad text out of the creative is on and the creative had legible text. Google archives text ads as pictures, so this is the only way the headline and body of a search ad can be returned at all - and it is a reading, not a field Google published.
creativeTextSource
Optional
Where creativeText came from. Currently always "ocr" when present, so downstream code can tell a read value from a published one without guessing.
searchQuery
Optional
The input query that matched this creative, when the task was a domain/brand search rather than an advertiser id.
isNew
Optional
Watch mode: true when this creative was absent from memory before this run.
isUpdated
Optional
Watch mode: true when a known creative's lastShownAt advanced since it was last seen — still running, not a new launch.
detailFetchedAt
Optional
When creative detail was fetched. Present when Fetch creative details is on and the per-ad lookup succeeded (a failed lookup is logged and skipped, not retried).
variantCount
Optional
Number of render variants returned by creative detail. Present under the same conditions as detailFetchedAt.
variants
Optional
Render variants (image/render URLs per variant) from creative detail. Present under the same conditions as detailFetchedAt.
