list_ads
Retrieve an advertiser's ads from Google's ad library by domain, with format, run dates, days shown, and links; filter by region and duration to spot long-running campaigns.
Instructions
List the ads an advertiser runs, from the Google Ads Transparency Center (Google's ad library). Free, no API key.
Returns one row per ad: advertiser name and ID, format, first shown, last shown,
days shown and a link to the ad. It does NOT return the ad text (headline,
description); use get_ads_with_copy for that.
Args:
domain: advertiser website, e.g. "nike.com".
region: 2-letter country code where the ad was shown, e.g. "US", "GB", "DE". Empty = all countries.
ad_format: "text", "image" or "video". Empty = all formats.
max_ads: how many ads to fetch, 1-200 (40 per page from Google).
min_days_shown: keep only ads shown on at least this many days. Use 30+ to find long-running ads.
sort: "recent" (most recently shown first) or "longest" (most days shown first).
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": {
"domain": "<domain>"
},
"name": "list_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | recent | |
| domain | Yes | ||
| region | No | ||
| max_ads | No | ||
| ad_format | No | ||
| min_days_shown | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |