Search volume and cost for a keyword list
keyword_volume is a $0.20 GET request on the Wuthering AI API. Price up to 1,000 keywords in a single billed call. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_volume
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_volume?keywords=…&token=YOUR_TOKEN'
What does keyword_volume return, and when should you call it?
Return search volume, cost per click, competition, and twelve months of monthly history for up to 1,000 keywords at once.
Reach for this at the two edges wuthering_keyword_overview cannot cover: a list longer than 700 terms, and terms so new or so rare that no index has seen them yet. This asks the ad platform itself, so it prices a keyword nothing has searched. Everywhere else prefer wuthering_keyword_overview, which costs the same per call and also returns difficulty, intent and trend. One call bills the same whether you send one keyword or a thousand, so batch rather than loop. It does NOT discover new keywords.
Returns: keyword, search_volume, competition, competition_index, cpc, low_top_of_page_bid, high_top_of_page_bid, monthly_searches.
search_volume is a smoothed typical-month figure, NOT the most recent month and not the exact mean of monthly_searches; it is rounded and will not tie out against those months arithmetically. On a seasonal or trending term the latest month can differ from it severalfold. Quote search_volume when asked how much a term is searched, and read monthly_searches when the question is about a specific month or the direction of travel.
One call accepts a thousand keywords; one RESPONSE cannot carry a thousand rows this size, because twelve months of history per keyword is most of the payload. A batch that overflows comes back trimmed to whole rows, and says how many rows it held and how many it returned — size the next call from that figure and send the terms you did not get. A term absent from a trimmed response was withheld, not measured at zero volume.
Use for term lists past 700, and for terms too new to be indexed. Don't use as the routine pricing step, where wuthering_keyword_overview answers the same question with more in it.
What parameters does keyword_volume take?
keyword_volume 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 1000 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_volume?
5 of the research skills name keyword_volume 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.
- 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 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_volume · last updated · published by Wuthering AI