Keywords a domain ranks for
domain_rankings is a $0.20 GET request on the Wuthering AI API. List every keyword a site ranks for, with position and traffic value. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/domain_rankings
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/domain_rankings?target=…&token=YOUR_TOKEN'
What does domain_rankings return, and when should you call it?
Return the keywords a domain currently ranks for in organic search, each with its position, the ranking URL, search volume, and estimated traffic value.
This is measured performance, not topical relevance. wuthering_domain_relevance answers what a site is ABOUT; this answers what it actually WINS. Comparing the two exposes the gap between positioning and results.
Returns: keyword, search_volume, and ranked_serp_element.serp_item with rank_absolute, url, and etv (estimated traffic value).
Use as the first move on any domain, yours or a competitor's. Don't use to find competitors themselves, which is wuthering_domain_competitors.
What parameters does domain_rankings take?
domain_rankings accepts 5 parameters, of which 1 is required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| target | string | yes | Domain to analyse, without protocol or path, for example 'example.com'. Works on your own site as readily as a competitor's. |
| 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 |
| limit | number | no | Maximum rows to return (1 to 1000, default 100). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 100 |
| offset | number | no | Rows to skip before returning results. Use with limit to page through a large set.Defaults to 0 |
Which playbooks call domain_rankings?
3 of the research playbooks name domain_rankings 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.
Reference for domain_rankings · last updated · published by Wuthering AI