Google Ads Transparency Center tools
Find a Google advertiser by name, list its active ads, and pull full creative variations and regional targeting per ad.
get_google_platform_id
| Parameter | Type | Notes |
|---|---|---|
brand_name |
string | e.g. “Nike” |
Returns two lists: advertisers (name, advertiser_id, region) and websites (domain). They can resolve to different accounts for the same brand, so the assistant is told to query both.
get_google_ads
| Parameter | Type | Notes |
|---|---|---|
domain |
string | Company-wide search, e.g. “nike.com” |
advertiser_id |
string | Specific account, e.g. “AR0161…” |
limit |
int | Default 100 |
topic |
string | Narrow by topic |
region |
string | Region code |
One of domain or advertiser_id is required. Each ad carries format, dates and an ad_url for the next tool. Impression data is not exposed at list level.
get_google_ad_details
| Parameter | Type | Notes |
|---|---|---|
ad_url |
string or string[] | From get_google_ads; lists fetch in parallel |
Returns text variations (headline, description, destination URL), regional targeting and impression ranges. Impression min and max can be null; that is a Transparency Center limitation. Image variations carry an imageUrl for analyze_ad_image.
Credits
One credit per call, one per URL in a batch.