Google Ads: Keyword ideas
ads_keyword_ideasResearch keywords for a client: search volume, competition and top-of-page bid range. Start here when building a campaign — never invent keywords or guess volumes. Put related seed keywords into ONE call (up to 20 seeds): Google allows about one Keyword Planner request a second per account, so separate calls are run one after another.
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": "ads_keyword_ideas"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The client's site or a service page, to seed from | |
| limit | No | Ideas to return, highest volume first (Google finds hundreds; the result says how many) | |
| seeds | No | Up to 20, e.g. ['cedar fence installation','fence company'] | |
| network | No | Volumes for Google Search only (Keyword Planner's default) or Search plus search partners | GOOGLE_SEARCH |
| customer_id | Yes | From ads_list_accounts | |
| geo_target_ids | No | From ads_find_locations |