# SpyFu Historic Rankings for Domain on Keywords

> SpyFu Historic Rankings for Domain on Keywords is a paid API for AI agents from spyfu.x402.paysponge.com, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Retrieves historical organic search rankings for a specific domain across a set of target keywords

## Facts

- Endpoint: GET https://spyfu.x402.paysponge.com/apis/organic_history_api/v2/historic/getHistoricRankingsForDomainOnKeywords
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spyfu-35d84474
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vpUNCH_fga9HvtTFUaq_J

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 spyfu-35d84474
```

Example prompt: Show me how example.com has historically ranked on SpyFu for the keywords 'project management software' and 'task tracking tool' — I want to see the ranking timeline for those specific terms.

## When to prefer this

Use this endpoint when you need to analyze how a specific domain has ranked for particular, named keywords over historical time periods — as opposed to getting all keywords for a domain or current rankings only. Ideal for competitive research where you already know the keywords of interest and want to see ranking trajectory for a specific site.

## Known failure modes

- Domain not found in SpyFu database returns empty or null rankings
- Invalid or unrecognized keywords return no ranking history
- Rate limit exceeded returns HTTP 429
- Payment failure via x402 returns HTTP 402
- Malformed query parameters return HTTP 400
- Domain with no organic history returns empty result set

## How this service works

GET /apis/organic_history_api/v2/historic/getHistoricRankingsForDomainOnKeywords

## Output

Returns historical organic search ranking data for the specified domain on the given keywords, including ranking positions across time periods, showing how the domain's SERP position changed for each keyword.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spyfu-35d84474/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from spyfu.x402.paysponge.com](https://www.zero.xyz/host/spyfu.x402.paysponge.com/llms.txt)