{"uid":"cap_nmXnFxRqZ_YEU-uCvXtdV","slug":"google-ads-transparency-scraper-dbbea717","name":"Google Ads Transparency Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/google-ads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"region":{"enum":["US","GB","CA","AU","DE","FR","IN","BR","JP","IT","ES","NL","MX","SG","ZA","ANYWHERE"],"type":"string","default":"US","description":"Country where ads were shown, or ANYWHERE for all available regions."},"domains":{"type":"array","description":"Destination domains to search exactly, such as example.com."},"endDate":{"type":"string","description":"Keep ads whose activity overlaps this YYYY-MM-DD date or earlier."},"queries":{"type":"array","description":"Names or domains to resolve to advertisers and their public ads."},"adFormat":{"enum":["ALL","TEXT","IMAGE","VIDEO"],"type":"string","default":"ALL","description":"Return all, text, image, or video creatives."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many dataset rows across all targets. Zero means no total cap."},"platforms":{"type":"array","items":{"enum":["SEARCH","YOUTUBE","SHOPPING","MAPS","PLAY"],"type":"string"},"default":[],"description":"Limit ads to selected surfaces. Empty means all surfaces."},"startDate":{"type":"string","description":"Keep ads whose activity overlaps this YYYY-MM-DD date or later."},"startUrls":{"type":"array","description":"Transparency Center advertiser or creative URLs, or URLs containing a domain or query parameter."},"resultType":{"enum":["ads","advertisers"],"type":"string","default":"ads","description":"Return ad creatives or one summary per advertiser."},"advertiserIds":{"type":"array","description":"Public advertiser IDs beginning with AR."},"includeDetails":{"type":"boolean","default":false,"description":"Add all available creative variations and country reach to each ad. This makes an extra request per ad."},"maxAdsPerSearch":{"type":"integer","default":100,"maximum":50000,"minimum":1,"description":"Maximum creatives read for each advertiser or domain and each selected platform."},"maxAdvertisersPerQuery":{"type":"integer","default":5,"maximum":10,"minimum":1,"description":"Maximum suggested advertiser accounts to inspect for each search term."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"domain":null,"format":null,"lastShown":null,"creativeId":null,"firstShown":null,"advertiserId":null,"shownForDays":null,"advertiserName":null}],"product":"google-ads"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fdmnKuvfN4EilFotQvQaq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured Google Ads Transparency Center data — ad creatives, advertisers, formats, and activity dates — for given domains, queries, or advertiser IDs.","exampleAgentPrompt":"Pull all Google text and image ads run by apple.com in the US between 2024-01-01 and 2024-06-30, up to 200 results, so I can see what creative campaigns they've been running.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Show me all the Google ads that nike.com has been running in the US since 2024-01-01 — I want to see every text and image creative, up to 300 results, across Search and YouTube."},{"title":"Brand advertising activity audit","prompt":"Look up the Google Ads Transparency Center data for 'Coca-Cola' and give me a summary of their advertisers and how many days each ad ran, for any region, covering the last year."},{"title":"Market entrant ad monitoring","prompt":"Search Google's ad transparency data for any ads targeting the UK from domains like monzo.com and revolut.com — I want text ads only, from 2023-06-01 to 2024-06-01, max 150 ads total."}],"resultDescription":"Returns a JSON array of ad creatives or advertiser summaries. Each item includes the advertiser name, advertiser ID, creative ID, destination domain, ad format, first and last shown dates, and number of days the ad was shown. The response also includes a total count and the product name.","failureModes":["Empty result set if the domain or query has no recorded ads in the selected region or date range (not charged)","Invalid advertiser ID format returns an error","Unsupported region or platform enum value causes validation failure","Date range with no overlapping ad activity returns an empty items array","Network timeout on large maxAdsPerSearch values"],"whenToPreferThis":"Use this endpoint when you need structured, queryable Google Ads Transparency data — specifically ad creatives, formats, activity dates, and advertiser metadata — without building your own scraper. Prefer it over manual Transparency Center browsing for batch lookups, competitive research, or programmatic monitoring. It is especially useful when you need to filter by region, platform, date range, or ad format in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:31.944Z","isFirstParty":false,"canonicalSlug":"google-ads-transparency-scraper-dbbea717"}