Google search and market data

Google Ads Transparency Scraper

Ads from Google's Ads Transparency Center per advertiser domain or advertiser id, per country or worldwide: creative id, advertiser name, preview image or preview URL, first and last shown dates and a link to the ad. Up to 200 advertisers per run. Pay only for delivered ads.

$1.40per 1,000 · Ad listed

One ad delivered. Advertisers without ads in the chosen region are never charged.

Call it from your code

curl
ACTOR=steadydata~google-ads-transparency
URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items"

curl -X POST "$URL?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"advertisers": ["nike.com", "booking.com"], "maxAdsPerAdvertiser": 100}'
python
import os, requests

ACTOR = "steadydata~google-ads-transparency"
URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items"

rows = requests.post(
    URL,
    params={"token": os.environ["APIFY_TOKEN"]},
    json={'advertisers': ['nike.com', 'booking.com'], 'maxAdsPerAdvertiser': 100},
    timeout=900,
).json()

# every row carries a status; failures are records, not exceptions
ok = [r for r in rows if r.get("status") == "ok"]
print(len(ok), "rows delivered")
javascript
const ACTOR = "steadydata~google-ads-transparency";
const url =
  `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` +
  `?token=${process.env.APIFY_TOKEN}`;

const rows = await fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"advertisers": ["nike.com", "booking.com"], "maxAdsPerAdvertiser": 100}),
}).then((r) => r.json());

// one object per delivered row, same shape every time
console.log(rows.filter((r) => r.status === "ok").length, "rows");

Use it in an agent

Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.

mcp url
https://mcp.apify.com?tools=steadydata/google-ads-transparency

# the tool arrives in your agent as steadydata--google-ads-transparency

Input

FieldTypeNameWhat it does
advertisers
required
array of stringAdvertisersAdvertiser domains (nike.com) or Transparency Center advertiser ids (AR...), one per row, up to 200. An advertiser without ads in the region comes back as a free error record.
countrystringCountry (empty = anywhere)Two-letter country code to see the ads shown in that country (US, GB, NL, DE ...). Leave empty for ads shown anywhere.
maxAdsPerAdvertiserintegerMax ads per advertiserCost ceiling per advertiser, newest first as the Transparency Center orders them. One delivered ad is one charged event.

What you get back

output schema, one object per delivered row
{
  "query": string | null,
  "advertiserId": string | null,
  "advertiserName": string | null,
  "domain": string | null,
  "creativeId": string | null,
  "rank": integer | null,
  "previewType": string | null,
  "previewImageUrl": string | null,
  "previewUrl": string | null,
  "previewWidth": integer | null,
  "previewHeight": integer | null,
  "formatCode": integer | null,
  "firstShown": string | null,
  "lastShown": string | null,
  "adUrl": string | null,
  "region": string | null,
  "status": string | null,
  "input": string | null,
  "errorCode": string | null,
  "error": string | null
}
FieldTypeWhen it is filled
querystring, null
advertiserIdstring, null
advertiserNamestring, null
domainstring, null
creativeIdstring, null
rankinteger, null
previewTypestring, null
previewImageUrlstring, null
previewUrlstring, null
previewWidthinteger, null
previewHeightinteger, null
formatCodeinteger, null
firstShownstring, null
lastShownstring, null
adUrlstring, null
regionstring, null
statusstring, nullEither 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged.
inputstring, nullThe input this row was built from, so a row can always be traced back.
errorCodestring, nullFilled on an error row only; a delivered row leaves it empty.
errorstring, nullFilled on an error row only; a delivered row leaves it empty.

Related datasets

Already using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.

Open the Apify page