ads_search_terms
Retrieve Google Ads search terms with cost and conversions to identify wasted spend and discover new keywords; filter by date range, campaign, or minimum cost.
Instructions
Search terms report: the actual queries that triggered ads, with cost and conversions (find wasted spend and new keywords).
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": {
"customerId": "<customerId>"
},
"name": "ads_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| endDate | No | ||
| minCost | No | ||
| dateRange | No | LAST_30_DAYS | |
| startDate | No | YYYY-MM-DD; overrides dateRange when used with endDate | |
| campaignId | No | ||
| customerId | Yes | Google Ads customer ID (with or without dashes) | |
| loginCustomerId | No | Manager (MCC) ID if accessing through a manager; defaults to ads.json |