Monthly rank history of a domain (24 months)
historical_rankHistorical rank: a domain's monthly Google visibility over the last 24 months: organic and paid ranking keywords, estimated traffic (etv), its ad value and position 1 / top 3 / top 10 / top 100 counts per month, in one $0.25 call. Use when you need a site's SEO trajectory, traffic drops or recoveries (bare domain; www. is dropped). A domain with no data returns an empty series (still charged). Bad input is free; upstream errors are not charged. Price: $0.25 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].
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": {
"target": "<target>"
},
"name": "historical_rank"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Bare domain like example.com (no scheme, path or port; a leading www. is dropped). | |
| country | No | Optional ISO 3166-1 alpha-2 code or country name, used when locationCode is absent (uk = gb). | |
| languageCode | No | Language code (2-letter). Defaults to en. An unsupported location falls back to 2840 (United States) with en (or the requested language if the United States offers it); a supported location with a language it does not offer uses that location's default language (en if offered). Either way market.fallback is true and market.warnings says what was used. | |
| locationCode | No | Google Ads location code (geo target ID). Defaults to 2840 (United States); an unsupported code falls back to 2840 (United States, market.fallback). |