Who ranks for a specific keyword set
domain_serp_rivals is a $0.20 GET request on the Wuthering AI API. Find the domains that own a particular list of keywords. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/domain_serp_rivals
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/domain_serp_rivals?keywords=…&token=YOUR_TOKEN'
What does domain_serp_rivals return, and when should you call it?
Given a list of keywords, return the domains ranking for them with average position and visibility.
This starts from KEYWORDS and finds domains. wuthering_domain_competitors starts from a DOMAIN and finds domains. Use this when you care about a specific battleground rather than a whole company.
Returns: domain, avg_position, median_position, rating, etv, keyword count.
Use once you have identified the terms that matter and want to know who holds them. Don't use for a broad competitive map.
What parameters does domain_serp_rivals take?
domain_serp_rivals accepts 4 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 200 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 |
| limit | number | no | Maximum rows to return (1 to 1000, default 50). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 50 |
Which playbooks call domain_serp_rivals?
4 of the research playbooks name domain_serp_rivals 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.
- 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 domain_serp_rivals · last updated · published by Wuthering AI