get_search_terms
Retrieve search terms matched to your keywords, filtered by date, campaign, and minimum impressions, ordered by clicks to prioritize high-engagement terms.
Instructions
Retrieve search terms that matched keywords, filtered by date and optional criteria.
Search terms are ordered by clicks (descending) to prioritize high-engagement terms.
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>",
"date_start": "<date_start>",
"date_end": "<date_end>"
},
"name": "get_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max rows returned to the caller (hard-capped at 10,000 by the API). | |
| date_end | Yes | end date in 'YYYY-MM-DD' format (inclusive). | |
| date_start | Yes | start date in 'YYYY-MM-DD' format (inclusive). | |
| campaign_id | No | Optional campaign id to filter search terms to a specific campaign. | |
| customer_id | Yes | Google Ads customer id (digits only; hyphens are stripped). | |
| min_impressions | No | Optional minimum impressions threshold (default 0 = no filter). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||