Search terms report
search_terms_reportReveals the actual search terms that triggered your Google Ads, with matched keywords, cost, clicks and conversions per term—plus total spend on terms that never converted—for an account, campaign or ad group.
Instructions
What people actually searched before clicking the ads: each term with the keyword it matched, cost, clicks and conversions, sorted by cost, with totals for spend on terms that never converted. Whole account, or one campaign or ad group.
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": {
"customer_id": "<customer_id>"
},
"name": "search_terms_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Look-back window in days, ending yesterday | |
| limit | No | Terms to list, by cost | |
| ad_group_id | No | Only this ad group (from campaign_details) | |
| campaign_id | No | Only this campaign (campaign_id from account_overview) | |
| customer_id | Yes | Google Ads customer ID, with or without dashes (from list_accounts) |