Keyword ideas (Keyword Planner)
keyword_ideasGenerate Google Keyword Planner ideas from seed keywords, a landing page URL, or a whole site, with search volumes, competition, and bid ranges ranked highest first. See what your account already targets or blocks.
Instructions
Google Keyword Planner ideas from seed keywords, a landing-page URL or a whole site: average and monthly searches, competition and the top-of-page bid range in the account's currency, biggest first. Ideas the account already targets, or already blocks as negatives, are marked in_account. 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>"
},
"name": "keyword_ideas"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | A page to pull ideas from, such as the ad's landing page | |
| site | No | A whole site's domain, yours or a competitor's (example.com), on its own | |
| limit | No | Most ideas to return | |
| months | No | Months of history to last month: 12 if left out, 48 most | |
| keywords | No | Up to 20 seed 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 | |
| min_searches | No | Drop ideas below this many average monthly searches |