Research keywords
research_keywordsIdeas from seeds: finds related keyword ideas with search volume, difficulty and CPC for 1-5 seed keywords in one call. For metrics on keywords you already have, use get_keyword_metrics. Estimated price per seed: ~$0.06 to $0.18 at 150 results, ~$0.10 to $0.29 at 300, ~$0.15 to $0.44 at 500 (Auto buys one to three sources), doubled with clickstream; ~$0.18 at any limit for countries served from Google Ads data, where difficulty/intent are unavailable. Asking again within 24 hours is answered from the saved copy at no charge: in Google Ads countries at any result limit, elsewhere for the same result limit and clickstream setting. Returns per-seed results, each with a link that reopens it in Keyword Research; a single bad seed won't fail the batch. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
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": {
"projectId": "<projectId>",
"seeds": "<seeds>"
},
"name": "research_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seeds | Yes | 1-5 seed keywords. Each seed is researched independently and returns related keywords with volume/difficulty/CPC. Bulk-friendly: prefer this over multiple single-seed calls. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| resultLimit | No | Max keywords returned per seed. Defaults to 150. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. | |
| includeClickstreamData | No | Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). DOUBLES the price of each seed. Default false (standard Google-Ads-derived volumes). No effect for countries served from Google Ads data. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| meta | No | ||
| results | Yes | ||
| savedResultId | No |