Google Ads Transparency / API Reference
google_ads_transparency_advertiser_ads
List the ads one advertiser is running in a country. Takes the advertiser_id from google_ads_transparency_find_advertiser. Covers Search, YouTube, Display and Shopping. Needs no account or connection. Args: advertiser_id: e.g. 'AR02934798844673654785'. region: Two-letter country code, e.g. 'US', 'IL', 'GB'. Ads are filtered to ones shown in that country. 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 advertiser 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 advertiser ads in my Google Ads Transparency account for [advertiser id].
It takes 1 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | Yes | Advertiser Id |
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_check_accessgoogle_ads_transparency_creative_mixgoogle_ads_transparency_find_advertisergoogle_ads_transparency_regionsgoogle_ads_transparency_search_ads
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.