Keyword volume and bids (Keyword Planner)
keyword_metricsFetches Google Keyword Planner search volume, competition, bid range, and monthly trends for an exact keyword list, so you can size keywords before adding them or check demand.
Instructions
Google Keyword Planner numbers for an exact list of keywords: average and monthly searches, competition and the top-of-page bid range in the account's currency. Use it to size keywords before adding them or to check a trend. Send the whole list in one call, not one per keyword: Keyword Planner rate-limits bursts. Over 100 come back as a compact table (columns, months, rows). Changes nothing.
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>",
"keywords": "<keywords>"
},
"name": "keyword_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | Months of history to last month: 12 if left out, 48 most | |
| keywords | Yes | Keywords to look up, up to 500 | |
| by_location | No | Also count each location alone, to compare markets (up to 100 keywords) | |
| customer_id | Yes | Google Ads customer ID, with or without dashes (from list_accounts) | |
| language_id | No | Language id (1000 English, 1001 German), name or code ("de"). Leave out for the campaigns' language, or every language when you name locations | |
| location_ids | No | Where to count searches; leave out for where the account's campaigns target. Each a geo target id (2840 United States, 2040 Austria), a country or its code ("Austria", "AT"), a place ("Springfield, Illinois"), or "worldwide" alone for every location |