ads_generate_historical_metrics
Retrieve read-only Keyword Planner search volume, monthly volume, competition, and bid ranges for supplied keywords to analyze historical ad performance.
Instructions
Return read-only Keyword Planner search volume, monthly volume, competition, and bid ranges for supplied keywords.
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": {
"keywords": "<keywords>"
},
"name": "ads_generate_historical_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes | ||
| customer_id | No | 10-digit Google Ads customer ID without hyphens; defaults to configured customer. | |
| language_id | No | 1000 | |
| geo_target_ids | No | ||
| year_month_range | No | Optional {start:{year,month}, end:{year,month}} historical range. | |
| include_average_cpc | No | ||
| keyword_plan_network | No | GOOGLE_SEARCH | |
| include_adult_keywords | No |