Keyword ideas from seed terms
keyword_ideas is a $0.20 GET request on the Wuthering AI API. Expand a handful of seed terms into the wider set of things people actually search. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_ideas
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_ideas?keywords=…&token=YOUR_TOKEN'
What does keyword_ideas return, and when should you call it?
Expand up to 200 seed keywords into the broader set of terms real searchers use, each with search volume, cost per click, competition, and difficulty.
This finds terms RELATED to your seeds by search behaviour. It does NOT tell you what a specific website ranks for (use wuthering_domain_rankings) and does NOT price a list you already have (use wuthering_keyword_volume, which is far cheaper per term).
Returns: keyword, search_volume, cpc, competition_level, keyword_difficulty, main_intent.
Use when you are mapping a category and need to know what language buyers use. Don't use when you already have the term list and only need numbers.
What parameters does keyword_ideas take?
keyword_ideas accepts 5 parameters, of which 1 is required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| keywords | array | yes | Keywords to look up, up to 200 in one call. This is one billed call regardless of how many you send, so batch aggressively rather than looping. A batch whose rows exceed what one response can carry comes back trimmed, stating how many rows it held and how many it returned; terms missing from a trimmed response were withheld, not measured as having no data. |
| location_code | number | no | Numeric location code to scope results to. Defaults to 2840 (United States). Search volume and competition vary sharply by country, so set this when the question is about a specific market.Defaults to 2840 |
| language_code | string | no | ISO language code for results, for example 'en' or 'de'. Defaults to 'en'.Defaults to en |
| limit | number | no | Maximum rows to return (1 to 1000, default 100). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 100 |
| offset | number | no | Rows to skip before returning results. Use with limit to page through a large set.Defaults to 0 |
Which playbooks call keyword_ideas?
3 of the research playbooks name keyword_ideas in their method. Each is free to read and says where in the sequence the call belongs.
- Is there real demand for this?Test an idea against the cheapest evidence that could kill it — search demand, sustained ad spend, posted salaries, and the words buyers use — and return a verdict with the number that decides it.
- Where is the unoccupied position in this category?Map the category around one domain as an idea maze — the forks it has already run, who took each branch, which walls are still walls and which have moved — then return the one open position with the offer that takes it: buyer, bundle, price metric and message, decided together.
- Where do the next 1,000 customers come from?Score every plausible channel against the product's own characteristics, measure the reachable demand and the cost of entry for each, and commit to one with its CAC and its ceiling stated.
Reference for keyword_ideas · last updated · published by Wuthering AI