Get a competitor's ads
get_competitor_adsCollects the ads one advertiser (or a domain) ran on Google Search, YouTube, Shopping, Maps and Play, in the project's country, from Google's Ads Transparency Center: each ad's format, when it was first and last shown, and a preview URL. Queued at normal priority: a 'processing' answer means call again with the same arguments in 2-3 minutes, at no extra cost. Estimated price: $0.01 for 40 ads, billed per 40. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
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": {
"projectId": "<projectId>"
},
"name": "get_competitor_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | How many ads to collect: 40, 80, 120. Defaults to 40. Billed per 40. | |
| domain | No | A domain whose advertisers' ads to collect, e.g. example.com. | |
| platform | No | Where the ads ran. Defaults to all. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| advertiserId | No | An advertiserId from find_ad_advertisers. Supply exactly one of advertiserId or domain. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ads | No | ||
| cost | No | ||
| meta | No | ||
| status | Yes | ||
| savedResultId | No |