# SEO Historical Rank Lookup

> SEO Historical Rank Lookup is a paid API for AI agents from seo.openverbs.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Returns the historical Google search ranking position for a domain across time, by language and location

## Facts

- Endpoint: POST https://seo.openverbs.com/v1/historical-rank?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-historical-rank-lookup-ac6fbf92
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_miI-zlUldo5cG0XLj8ZEv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability seo-historical-rank-lookup-ac6fbf92 -d '<json body>'
```

Example prompt: Can you pull up the historical Google search ranking for shopify.com in the United States — I want to see how their rank has changed over time?

## When to prefer this

Choose this endpoint when you need time-series Google ranking history for a specific domain, particularly for tracking SEO progress after campaigns, auditing competitor rank trajectories, or benchmarking domain authority changes in specific geographic markets. It is backed by DataForSEO data and supports per-country and per-language scoping, making it superior to generic rank checkers when international SEO intelligence is needed. Prefer this over the domain traffic overview endpoint when you specifically want rank position history rather than traffic volume estimates.

## Known failure modes

- Domain not found or has no ranking history — returns empty or null result
- Invalid domain format (with scheme or path included) — API strips www/scheme but may reject malformed input
- Invalid language code (not 2-letter ISO) — schema validation error
- Invalid or unsupported DataForSEO location code — may return error or fall back to default
- No historical data available for that domain/location/language combination
- Payment failure via x402 protocol — call not completed

## How this service works

Historical rank overview API - a monthly time series of a domain's Google organic and paid visibility: ranked keyword count, estimated traffic (ETV), traffic cost and position buckets (pos1/top3/top10/top100) for each month. For tracking a site's SEO trajectory, spotting traffic drops/recoveries and competitor trend analysis. Unknown domain returns an empty series.

## Output

Returns historical Google search ranking positions for the specified domain, showing how its SERP standing has changed over time for the given language and geographic market. Typically includes rank data points across a time series, enabling trend analysis and campaign impact assessment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 253,
   "minLength": 3,
   "description": "Bare domain, e.g. stripe.com (scheme, www and path are stripped)."
  },
  "languageCode": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "description": "Language code (2-letter). Defaults to en."
  },
  "locationCode": {
   "type": "integer",
   "description": "DataForSEO location code. Defaults to 2840 (United States)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-historical-rank-lookup-ac6fbf92/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seo.openverbs.com](https://www.zero.xyz/host/seo.openverbs.com/llms.txt)