Candidate keywords around a seed, with volume, difficulty, intent, CPC and trend for each.
Use when: "find keywords for X", "what should I target around X", "keyword ideas for a page about X".
Not for: metrics on keywords the user already has, use seo_get_keyword_metrics (this tool already returns those metrics, so do not call it afterwards). Prompts people ask AI engines, use aeo_search_prompts. The top-10 page for one query, use seo_get_serp.
Returns: List. rows[]: keyword, volume, kd (0 to 100), intent, cpc (USD), competition, bid_low, bid_high (Google Ads top-of-page bid range, USD), trend[12] (month, volume). volume, kd, cpc null = provider has no data; 0 = measured zero.
Cost: 5 + 5 per 100 rows. Default 100 rows = 10 credits. Cached 7 days.
Example: {"seed": "crm for startups", "mode": "suggestions", "limit": 50}