Load domain overview history
load_domain_overview_historyLoads the separately priced historical index series for an unexpired Domain Overview snapshot; set max_cost_cents to cap spend or 0 for cache-only.
Instructions
Requires API write scope and an explicit max_cost_cents because a cache miss can spend provider budget. Use zero for cache-only. Loads the separately priced historical index series for an unexpired Domain Overview snapshot. snapshot_expired means analysis must run again before history can be loaded.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"language_code": "<language_code>",
"location_code": "<location_code>",
"project_id": "<project_id>",
"target": "<target>",
"max_cost_cents": "<max_cost_cents>"
},
"name": "load_domain_overview_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fresh | No | Bypass cached module data and request fresh provider data. | |
| target | Yes | Domain or subdomain to analyze. | |
| project_id | Yes | Project id whose provider connection, budget, and Domain Overview snapshot are used. | |
| language_code | Yes | Language code used for the provider lookup, for example en. | |
| location_code | Yes | Positive DataForSEO location code identifying the lookup market. | |
| max_cost_cents | Yes | Maximum provider cost for this request, in cents. Use zero for an explicit cache-only attempt. | |
| scope_override | No | Override automatic target scope detection with root-domain or subdomain scope. |