Full metrics for known keywords
keyword_overview is a $0.20 GET request on the Wuthering AI API. Get every available metric, including trend, for keywords you already have. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_overview
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_overview?keywords=…&token=YOUR_TOKEN'
What does keyword_overview return, and when should you call it?
Return the complete metric set for up to 700 known keywords, including the monthly and yearly search-volume trend.
This is the default way to put numbers on a list you already have. It returns everything wuthering_keyword_volume returns and adds difficulty, intent and trend, for the same price per call, so a list of 700 or fewer has no reason to go anywhere else. It does NOT discover new terms.
Returns: keyword, search_volume, cpc, competition, keyword_difficulty, search_intent, and search_volume_trend with monthly and yearly change.
It answers from an index of keywords already observed, so a term that index has never seen comes back without metrics. That is an absence of data, NOT a measurement of zero: price those terms with wuthering_keyword_volume, which asks the ad platform directly and will return a figure for a keyword nothing has searched yet.
Use as the pricing step after any discovery tool. Don't use for a list past 700 terms, which is what wuthering_keyword_volume is for.
What parameters does keyword_overview take?
keyword_overview accepts 3 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 700 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 |
Which skills call keyword_overview?
7 of the research skills name keyword_overview 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.
- Who are we really up against?Work April Dunford's positioning sequence from public evidence: the alternatives a prospect would actually use, what only you do, the value that follows, who cares most, and the category that makes all of it obvious.
- What do we charge, and does the money work?Anchor price against what competitors actually charge and meter on, size willingness to pay from what the problem costs today, then run CAC, LTV and payback across three scenarios.
- 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.
- What should we build next?Gather the language of people switching into and out of this category, code every quote to the force that drives it, size each theme against real search demand, and return a 50/50 roadmap.
- What would prove us wrong?Turn a belief the plan depends on into an explanation that cannot be bent to fit any result, name the rival explanations that would produce the same evidence, and pay only for the observations that would come out differently under each.
Reference for keyword_overview · last updated · published by Wuthering AI