Data APIs / Google Ads

Google Ads Transparency Center API

Query the Google Ads Transparency Center by domain and get the advertiser's ads back as structured data: format, dates shown, regions, and creative previews — without clicking through the site.

From 1 credit per call · cache hits free · failed calls refunded · no card for the free tier

One request, structured data and markdown

Every endpoint accepts format=json, markdown, or both. Use the JSON to filter and store; drop the markdown straight into a prompt.

  • Advertiser id and verified name for a domain
  • Drill into any creative: format, every preview variant, dates, regions
  • Each ad's format (text, image, video), first and last shown dates, and regions
  • Creative preview URLs
  • Paginated results with max_pages
request
curl 'https://scrapewhale.dev/api/v1/ads/google?domain=nike.com&format=json' \
  -H 'Authorization: Bearer <api-key>'
response · json
{
  "extractor": "google-ads",
  "creditsCharged": 2,
  "data": {
    "advertiser": { "id": "AR0123…", "name": "Nike, Inc." },
    "count": 40,
    "ads": [
      { "format": "VIDEO", "first_shown": "2026-07-01", "last_shown": "2026-08-25", "regions": ["US", "GB"], "preview_url": "https://…" }
    ]
  }
}

Abridged.

Endpoints

3 endpoints in this family. Full parameter reference and a try-it console are in the API docs.

get/api/v1/ads/google2 credits

Ads a domain is running (Google Ads Transparency Center)

Ad creatives a domain is running, scraped from Google's Ads Transparency Center (which has no official API). Returns creative ids with Transparency Center links in markdown and the raw creative items in data. 40 creatives per page.

domain *
The advertiser domain. Accepts a bare domain or a full URL.
max_pages
Pages of 40 creatives to fetch (1–20, default 3).
get/api/v1/ads/google/creative1 credit

Google ad creative detail

One creative from the Google Ads Transparency Center: format (text / image / video), every preview variant, first and last shown dates, the regions it ran in, and the advertiser block. Use the AR… / CR… ids from /api/v1/ads/google items. Google does not expose landing URLs for any format.

advertiser_id *
Advertiser id (AR…), key 1 of an /ads/google item.
creative_id *
Creative id (CR…), key 2 of an /ads/google item.
include_advertiser
Set false to skip the embedded advertiser lookup.
get/api/v1/ads/google/advertiser1 credit

Google Ads advertiser identity

Who is behind an AR… advertiser id in the Google Ads Transparency Center: display name, legal name, country, and verification status.

advertiser_id *
Advertiser id (AR…).

What teams use it for

Is this company advertising?

Instant yes/no plus volume — a strong buying-intent signal for sales teams.

Search-ad copy research

Read the headlines and descriptions a competitor is testing.

Market mapping

Run every domain in a category and rank them by ad count.

Frequently asked questions