A domain's search performance over time
domain_history is a $0.20 GET request on the Wuthering AI API. Track how a domain's organic visibility has moved across months. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/domain_history
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/domain_history?target=…&token=YOUR_TOKEN'
What does domain_history return, and when should you call it?
Return the historical series of a domain's organic and paid metrics, one point per month.
Costs roughly ten times a standard call, so reach for it once a domain has proven worth the attention rather than as a first look. Shows direction of travel, which a single snapshot cannot.
Returns: per-month metrics.organic and metrics.paid with count, etv, and position buckets.
Covers the last 24 months by default and will not reach further back than that in one call: this endpoint bills by the month returned, so an open-ended window is an open-ended response. Set date_from and date_to to move the window; ask for an older span in a second call rather than a wider one.
Use to tell a company that is growing from one that peaked two years ago. Don't use as an opening move; wuthering_domain_overview is the cheap version.
What parameters does domain_history take?
domain_history 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. |
| date_from | string | no | Earliest month to report, as YYYY-MM-DD. Defaults to 24 months before date_to, which is also the furthest back one call reaches. |
| date_to | string | no | Latest month to report, as YYYY-MM-DD. Defaults to the most recent data available. |
| 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 skills call domain_history?
2 of the research skills name domain_history in their method. Each is free to read and says where in the sequence the call belongs.
- 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 domain_history · last updated · published by Wuthering AI