Get Search Terms Report
get_search_terms_reportRetrieve actual search terms that triggered your ads to identify new keyword opportunities and negative keyword candidates.
Instructions
Get the search terms report — actual searches that triggered your ads.
Useful for finding new keyword opportunities and negative keyword candidates.
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": "get_search_terms_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of search terms to return (default: 100, max: 500) | |
| date_range | No | Date range for metrics (default: LAST_30_DAYS) | LAST_30_DAYS |
| manager_id | No | Manager ID if access type is 'managed' | |
| campaign_id | No | Optional — filter to a specific campaign ID | |
| customer_id | Yes | The Google Ads customer ID (10 digits, no dashes) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||