Ad Copy + Image OCR — Google Ads Transparency Scraper
Pricing
from $0.80 / 1,000 ad results
Every ad an advertiser runs on Google, with the real copy: headline, body, CTA, display and landing URLs, plus {KeyWord:...} templates and run dates. Image ads are read by a vision model, not Tesseract. Political mode adds spend and impressions. Search by domain, brand or ID. No login.
advertiser_name
Optional
The verified advertiser's name as Google publishes it.
advertiser_id
Optional
Google's stable identifier for the advertiser (AR...). Join on this across runs and regions.
creative_id
Optional
Google's stable identifier for this ad creative (CR...). Deduplicate on this.
ad_format
Optional
text for search and responsive ads, image for display creatives, video for video ads. Google returns text and video ads identically, so video is only distinguished when includeAdCopy is on — with it off, video ads are labelled text.
ad_surface
Optional
Which Google surface the ad ran on — search, shopping, youtube, or display for an HTML5 animated creative — read from the creative's own shape. Needs the ad-copy fetch on; null when the creative was not opened.
headline
Optional
The ad's headline, as written by the advertiser — including any {KeyWord:...} insertion template. Null on pure image and video creatives, which carry no text component.
body_text
Optional
The ad's body copy, as written by the advertiser.
ad_ocr_text
Optional
Text read out of the creative's pixels, in reading order. Filled for text ads that Google publishes only as a screenshot whenever ad copy is on, and for image ads when ocrImageAds is on — and only when the image actually carried words.
headlines
Optional
Every headline variant on the creative. Responsive ads carry several and Google rotates them; the primary headline is the first of these.
descriptions
Optional
Every body-copy variant on the creative, for the same reason as headlines.
display_url
Optional
The display URL shown in the ad (the domain the ad presents itself as).
destination_url
Optional
The landing page the ad actually clicks through to, including its campaign path — the page they are spending money to send traffic to, not just the domain they display.
cta
Optional
The ad's call-to-action button text, as written — INSTALL, Sign up, Jetzt buchen. Present on the display, app and video creatives that carry one; measured at 14 of 48 creatives with copy across seven advertisers. Search ads have none — their button is the headline.
keyword_templates
Optional
The advertiser's raw keyword-insertion values, pulled out of {KeyWord:...} in the headline and body — the terms they bid on and swap into the ad. No other actor in this category exposes this field.
extensions
Optional
Location and sitelink extensions attached to the creative, when present — store name, address, city, postcode, country, and category.
first_shown
Optional
The date this creative was first shown, as Google reports it.
last_shown
Optional
The date this creative was last shown. A last-shown date in the past means the ad has stopped running.
days_shown
Optional
How many days the creative has been running. The single best public proxy for whether an ad converts — long-lived ads are ads someone keeps paying for.
impressions_max
Optional
Upper bound of how many times the creative was shown. Political ads only.
impressions_min
Optional
Lower bound of how many times the creative was shown. Political ads only.
spend_currency
Optional
Currency of the spend range, e.g. USD. Political ads only.
spend_max
Optional
Upper bound of what the advertiser spent on this creative. Political ads only.
spend_min
Optional
Lower bound of what the advertiser spent on this creative. Political ads only — Google publishes spend as a range, never an exact figure.
image_url
Optional
The creative's image, for display ads.
image_width
Optional
Image width in pixels.
image_height
Optional
Image height in pixels.
preview_url
Optional
Google's own rendered preview of the creative. This is the field competing actors return instead of the ad copy.
target_domain
Optional
The domain the search matched this creative on. Present when you search by domain, so you can tell which of several domains in one run produced a row.
regions
Optional
Countries the creative declares it ran in. Google publishes this for political advertisers, where disclosure is mandatory; commercial ads usually leave it empty.
region
Optional
The country the ads were searched in, as a two-letter code.
ad_url
Optional
The creative's page in Google's Ads Transparency Center, for verification by hand.
advertiser_country
Optional
The advertiser's country of registration, as Google verified it. Only on advertisers records.
advertiser_ad_count
Optional
How many ads this advertiser has published in total, as the source counts them. Advertiser results are sorted by it, because the source ranks matches by name similarity — a search for a big brand otherwise leads with tiny lookalike accounts.
advertiser_verified
Optional
Whether Google has verified this advertiser's identity. Only on advertisers records.
matched_query
Optional
The domain or search term that matched this advertiser. Only on advertisers records.
advertiser_url
Optional
The advertiser's page in Google's Ads Transparency Center. Only on advertisers records.
raw
Optional
The source's untouched record for this creative, present only when includeRawData is on.
advertiser_legal_name
Optional
The advertiser's registered legal name, as verified by Google. Political advertiser records only.
advertiser_fec_id
Optional
The committee's FEC identifier, e.g. C00786657 — the key that joins this advertiser to US campaign-finance filings. Political advertiser records only.
advertiser_office
Optional
Office sought, as filed: H House, S Senate, P President. Political advertiser records only.
advertiser_district
Optional
District contested, e.g. SC-07. Political advertiser records only.
advertiser_ads_min
Optional
Lower bound of how many ads this advertiser has run in total. Political advertiser records only.
advertiser_ads_max
Optional
Upper bound of how many ads this advertiser has run in total.
advertiser_impressions_min
Optional
Lower bound of how many times this advertiser's ads were shown in total. Political advertiser records only.
advertiser_impressions_max
Optional
Upper bound of how many times this advertiser's ads were shown in total.
advertiser_spend_total
Optional
Total spent by this advertiser on Google ads, to the dollar — not a range. Read from the same statistics the Ads Transparency Centre shows on its Insights tab. Political advertiser records only.
advertiser_spend_currency
Optional
Currency of advertiser_spend_total, e.g. USD.
advertiser_ads_total
Optional
Exact number of ads this advertiser has run, as the statistics endpoint reports it — the advertiser card only carries a range.
spend_by_day
Optional
Daily spend history for the advertiser — one row per day with date, spend_share and spend in the advertiser's currency. Hundreds of days for an established campaign. Political advertiser records only.
spend_by_region
Optional
Where the money went — one row per region with the place region named (South Carolina), its region_canonical and region_country, alongside spend_share, spend, and ads_share, the share of the advertiser's ads that ran there. Note ads_share does not sum to 1: one ad runs in many regions. Political advertiser records only.
spend_by_format
Optional
Spend split by creative format, with the share of ads in each. Political advertiser records only.
record_type
Optional
removed_ad on rows from the Europe removal feed. Absent on ordinary ad records.
policy_decided_at
Optional
When Google decided to remove the ad. Removal-feed rows only.
removal_reason
Optional
The headline reason the ad was removed, e.g. Misrepresentation or Account suspension — the first named violation on the record. Removal-feed rows only.
violations
Optional
What the ad was removed for: one entry per violation with the named policy and policy_category — Misrepresentation / PROHIBITED PRACTICES — alongside Google's raw codes. Google publishes the taxonomy as numbers only; the names here were derived by pairing 280 feed rows against the labels the Ads Transparency Centre renders for those same rows. A code outside the derived set keeps its number and a null name rather than a guess. Removal-feed rows only.
