Get Keyword Performance
get_keyword_performanceRetrieve Google Ads keyword performance data, including match type, status, quality score, and core metrics, ordered by highest cost to identify top-spending keywords.
Instructions
Keyword-level performance report: keyword text, match type, status, quality score, and the core metrics. Ordered by cost, highest first.
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_keyword_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return (default 200). | |
| end_date | No | Optional custom range end (YYYY-MM-DD). | |
| date_range | No | Predefined range (see get_campaign_performance). | LAST_7_DAYS |
| start_date | No | Optional custom range start (YYYY-MM-DD). | |
| campaign_id | No | Optionally restrict to a single campaign. | |
| customer_id | Yes | The Google Ads account to report on. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |