Google Ads Transparency / API Reference
google_ads_transparency_search_ads
Look up a brand's Google ads in one call. The default way in: resolves the brand name to the best-matching verified advertiser, then returns their ads. Use google_ads_transparency_find_advertiser instead when several businesses share the name and you need to pick deliberately. Needs no account, connection or API key, and works in 180+ countries — this is the tool to reach for when Meta's Ad Library returns nothing because the advertiser is outside the EU/UK. Args: query: Brand, company or domain, e.g. 'nike', 'booking.com'. region: Two-letter country code, e.g. 'US', 'IL', 'GB'. format: Optional filter — 'TEXT', 'IMAGE' or 'VIDEO'. Blank for all. limit: Max ads to return, up to 200. Default 40. refresh: Skip the cache and ask Google again.
This is a read-only tool: it returns transparency search ads for your Google Ads Transparency account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Transparency search ads in my Google Ads Transparency account for [query].
It takes 1 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Query |
region | string | No | Region |
format | string | No | Format |
limit | integer | No | Limit |
refresh | boolean | No | Refresh |
Related Google Ads Transparency tools
google_ads_transparency_ad_detailsgoogle_ads_transparency_advertiser_adsgoogle_ads_transparency_check_accessgoogle_ads_transparency_creative_mixgoogle_ads_transparency_find_advertisergoogle_ads_transparency_regions
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.