Forecast clicks and spend for keywords
keyword_forecast is a $0.20 GET request on the Wuthering AI API. Estimate the clicks, cost, and CPC a keyword set would produce at a given bid. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_forecast
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_forecast?keywords=…&token=YOUR_TOKEN'
What does keyword_forecast return, and when should you call it?
Forecast the traffic and spend a set of keywords would generate at a stated bid and match type over a chosen period.
Returns ONE aggregate row for the whole set, not per-keyword numbers. This is the tool that turns a keyword list into a cost-per-acquisition estimate, so it is usually the last step before an economic judgement.
Returns: impressions, clicks, average_cpc, cost, ctr for the set as a whole.
Use to sanity-check whether a channel can pay for itself. Don't use for per-keyword cost, which is cpc from wuthering_keyword_volume.
What parameters does keyword_forecast take?
keyword_forecast accepts 6 parameters, of which 2 are 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. |
| bid | number | yes | Maximum cost-per-click bid in whole currency units, for example 5 for $5.00. |
| match | string | no | Keyword match type. 'exact' gives the most conservative estimate.One of: exact, broad, phraseDefaults to exact |
| date_interval | string | no | Forecast window. Defaults to 'next_month'.One of: next_week, next_month, next_quarterDefaults to next_month |
| 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_forecast?
2 of the research playbooks name keyword_forecast in their method. Each is free to read and says where in the sequence the call belongs.
- 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.
Reference for keyword_forecast · last updated · published by Wuthering AI