google ads get search terms
google_ads_get_search_termsFetch Google Ads search term performance for a date range, choosing search_term_view or campaign_search_term_insight, to analyze queries and optimize keywords.
Instructions
Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.
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>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "google_ads_get_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| endDate | Yes | End date YYYY-MM-DD | |
| adGroupId | No | Optional ad group ID filter. Applies directly to search_term_view and via segments.ad_group for insight reports. | |
| startDate | Yes | Start date YYYY-MM-DD | |
| campaignId | No | Optional campaign ID filter | |
| customerId | Yes | Google Ads customer ID (without dashes, e.g., 1234567890) | |
| reportType | No | Native provider report type; determines supported metrics and dimensions. | search_term_view |
| searchTermContains | No | Optional substring filter for search_term_view |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |