Load domain overview keywords
load_domain_overview_keywordsLoad one page of ranked keywords for a Domain Overview target, with budget control to prevent provider spend. Use zero cost for cache-only; rerun analysis if the snapshot expired.
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 one ranked-keyword page for the current Domain Overview target; snapshot_expired means analysis must run again first.
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>",
"offset": "<offset>",
"limit": "<limit>"
},
"name": "load_domain_overview_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fresh | No | Bypass cached module data and request fresh provider data. | |
| limit | Yes | Number of ranked keyword rows to load, from 1 through 100. | |
| offset | Yes | Zero-based provider row offset for this page. | |
| 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. |