Google ads run by an advertiser
google_advertiser_adsFor competitive ad research: lists ads a company has run on Google, as published in the Google Ads Transparency Center, newest first. Give 1-3 domains (nike.com), advertiser IDs (AR...) or Transparency Center advertiser URLs (a domain lookup can also return other advertisers that Google associates with that domain; an advertiser ID returns only that account). Returns advertiser, format (text, image, video), first and last shown dates, days running, whether it is still running, a preview image link and the Transparency Center link. Filter by region, platform, format and recency. Billed per ad returned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"targets": "<targets>"
},
"name": "google_advertiser_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Ads per target (default 20, max 40). Billed per ad returned. | |
| region | No | Where the ads were shown: country code (US, DE), country name, or "anywhere" (default US). | |
| date_to | No | Only ads shown on or before this date, YYYY-MM-DD (needs date_from). | |
| targets | Yes | 1-3 domains, advertiser IDs (AR followed by digits) or adstransparency.google.com advertiser URLs. | |
| platform | No | Where the ads ran (default all). | |
| ad_format | No | Creative format (default all). | |
| date_from | No | Only ads shown on or after this date, YYYY-MM-DD. | |
| last_shown_within_days | No | Only ads shown in the last N days (1-2 = running now). |