get_ads_with_copy
Retrieve Google ads with ad copy—headlines, descriptions, display URLs, countries, including screenshot-only text ads—to analyze advertiser messaging.
Instructions
Get Google ads WITH their ad copy (headline, description, display URL), including text ads that Google stores only as screenshots, plus the countries each ad ran in.
Runs the hosted Apify Actor "datalume/google-ads-transparency-scraper" with your own
Apify account. Requires the APIFY_TOKEN environment variable. It is PAID per result
(about $0.002 per ad, $0.0035 per ad with copy on Apify's free plan; failed rows are free).
The run stops at max_total_charge_usd. Prefer list_ads when the ad text is not needed.
Args:
domains: advertiser websites, e.g. ["booking.com"].
advertiser_names: advertiser names to look up, e.g. ["Samsung Electronics"].
region: 2-letter country code (e.g. "US") or "anywhere".
platform: "all", "search", "youtube", "shopping", "maps" or "play".
ad_format: "all", "text", "image" or "video".
min_days_running: keep ads shown on at least this many days.
sort_by: "recentlyShown", "longestRunning" or "newest".
max_ads_per_target: maximum ads per domain or name (keep small to control cost).
max_total_charge_usd: hard spending cap for this call, in USD.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_ads_with_copy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | anywhere | |
| domains | No | ||
| sort_by | No | recentlyShown | |
| platform | No | all | |
| ad_format | No | all | |
| advertiser_names | No | ||
| min_days_running | No | ||
| max_ads_per_target | No | ||
| max_total_charge_usd | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |