{"uid":"cap_Z8FuR4rukUi8E5sI3RK3o","slug":"google-ads-transparency-scraper-7faacb05","name":"Google Ads Transparency Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_FJRI4WFBqrcmpz5mLVXF_","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":"Retrieves structured ad creatives and advertiser data from Google's Ads Transparency Center by domain, query, or advertiser ID","exampleAgentPrompt":"Pull all text and image ads that nike.com has run on Google Search and YouTube in the US since 2024-01-01, up to 200 results, and show me the creative IDs, first and last shown dates, and advertiser name.","exampleUseCases":[{"title":"Competitor ad creative audit","prompt":"Show me all the Google ads that Shopify.com has been running in the US this year — I want to see text and image creatives across Search and Shopping, up to 150 ads total."},{"title":"Brand YouTube ad monitoring","prompt":"Find all video ads run by Apple on YouTube globally since 2023-06-01, give me the creative IDs and how long each ad was shown, limit to 50 results."},{"title":"Market advertiser landscape research","prompt":"Who are the top advertisers running Google ads targeting the UK market with domains like monzo.com and revolut.com? Return one summary per advertiser rather than individual ads."}],"resultDescription":"Returns a JSON object with a count and an array of items, each containing ad creative metadata: domain, format, lastShown, creativeId, firstShown, advertiserId, shownForDays, and advertiserName. Can also return one summary row per advertiser when resultType is set to advertisers.","failureModes":["No ads found for the specified domain or query — empty items array returned but not charged","Invalid advertiser ID format (must begin with AR) — likely returns error or empty result","Date range produces no matching activity — empty result","Region or platform combination yields no data for the target advertiser","Rate limits or Google Transparency Center unavailability may cause scrape failure — not charged on failure","Overly broad query with default maxItems may truncate results"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable ad creative data from Google's Ads Transparency Center — especially for competitor research, ad auditing, or brand monitoring across Google Search, YouTube, Shopping, Maps, and Play. Prefer this over manual Transparency Center browsing when you need bulk data, date filtering, or programmatic access. It is pay-per-call with no charge on empty or failed runs, making it cost-safe for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:55:24.876Z","isFirstParty":false,"canonicalSlug":"google-ads-transparency-scraper-7faacb05"}