How hard keywords are to rank for
keyword_difficulty is a $0.20 GET request on the Wuthering AI API. Score up to 1,000 keywords 0-100 on ranking difficulty. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/keyword_difficulty
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/keyword_difficulty?keywords=…&token=YOUR_TOKEN'
What does keyword_difficulty return, and when should you call it?
Return a 0 to 100 difficulty score for up to 1,000 keywords, where higher means established competition is harder to displace.
Difficulty describes ORGANIC ranking effort only. It says nothing about paid cost, which is cpc from wuthering_keyword_volume, and the two often disagree.
Returns: keyword, keyword_difficulty.
Use to sort a priced list into what is winnable. Don't use alone: a low-difficulty keyword with no volume is not an opportunity.
What parameters does keyword_difficulty take?
keyword_difficulty 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 playbooks call keyword_difficulty?
2 of the research playbooks name keyword_difficulty in their method. Each is free to read and says where in the sequence the call belongs.
- 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_difficulty · last updated · published by Wuthering AI