Search volume month by month
keyword_history is a $0.20 GET request on the Wuthering AI API. Get multi-year monthly search history for a keyword list. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_history
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_history?keywords=…&token=YOUR_TOKEN'
What does keyword_history return, and when should you call it?
Return the full monthly search-volume history available for up to 700 keywords.
This is how you separate a durable shift from a seasonal spike or a news bump. It reports history only and makes no forecast; for forward-looking numbers use wuthering_keyword_forecast.
Returns: keyword, then a history array of year, month, search_volume, cpc, and competition.
Use when the question is whether demand is growing. Don't use for a point-in-time read, where wuthering_keyword_volume is cheaper.
What parameters does keyword_history take?
keyword_history 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 playbooks call keyword_history?
4 of the research playbooks name keyword_history 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.
- Is this company actually growing?Read one company's trajectory from public evidence: branded demand year over year, the acquisition engine underneath it, whether that demand was earned or bought, and what payroll says ships next — then name the questions only a data room can close.
- 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_history · last updated · published by Wuthering AI