Keyword Ideas
Get question and long-tail keyword ideas for a seed term. One call fans the seed out across Google autocomplete, People Also Ask and related searches, then returns deduplicated ideas with a source, an intent label and a relevance score.
Request
curl -X POST https://api.alterlab.io/api/v1/serp/keyword-ideas \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"seed": "web scraping api", "country": "us", "language": "en"}'seed: the keyword or phrase, 1 to 200 characters. Required.country: two-letter ISO country code. Defaultus.language: language code. Defaulten.depth:1(default) fans out the seed with a to z and the question prefixes who, what, how, why, best and vs.2also expands the best ideas, up to 60 calls.sources: any ofautocomplete,paaandrelated. Default all three.quote_only: set totrueto get the price without running or billing anything.
Response
The response repeats the request settings and returns ideas, a quote and billing. Each idea has a keyword, the sources that produced it, an is_question flag, an intent (question, commercial, navigational or informational) and a relevance_score from 0 to 1.
volume is always null. AlterLab has no search-volume data, and the score reflects how often and how high an idea appears across sources, not how many people search for it. Use it to find what to write about, then check volume in a tool that measures it.
Price and Caching
The quote shows autocomplete_calls, serp_calls and the total in microcents and USD before anything runs, and equals the amount debited. Failed or unused calls are refunded. Results are cached for 7 days per seed, country and language, and a cache hit costs half the quote. billing.cache_hit tells you which one you got. An insufficient balance returns 402, and 503 means every call failed and nothing was billed.
MCP Tool
alterlab_keyword_ideas takes seed, country, language, depth, sources and quote_only. The CLI and SDKs reach the same endpoint. For full results pages rather than keyword ideas, use the SERP API.