# SpyFu Gained Ranks Keywords (via Sponge/x402)

> SpyFu Gained Ranks Keywords (via Sponge/x402) is a paid API for AI agents from spyfu.x402.paysponge.com, paid per call via x402, $0.010000/call, status down (last checked 2026-09-15).

Returns keywords for which a domain has recently gained search engine rankings, powered by SpyFu's SERP data.

## Facts

- Endpoint: GET https://spyfu.x402.paysponge.com/apis/serp_api/v2/seo/getGainedRanksKeywords
- Price: $0.010000/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spyfu-02289df1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N58siUQsvB1BU1zaRT8NW

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-02289df1
```

Example prompt: Which keywords has example.com recently gained rankings for in organic search? I want to see new or improved keyword positions SpyFu is tracking for that domain.

## When to prefer this

Use this endpoint when you need to identify which keywords a domain has recently started ranking for or improved position on, particularly for competitive SEO monitoring, content gap analysis, or tracking the impact of SEO efforts. Prefer this over general keyword lookup endpoints when the specific goal is discovering newly-gained or improved organic rankings.

## Known failure modes

- Missing or invalid domain parameter returns an error or empty result
- Domain not tracked by SpyFu returns empty keyword list
- Payment failure via x402 returns 402 status before data is served
- Rate limiting or quota exhaustion returns an error response
- Malformed query parameters may cause 400 Bad Request

## How this service works

GET /apis/serp_api/v2/seo/getGainedRanksKeywords

## Output

A list of keywords for which the queried domain has recently gained search engine rankings, including rank positions, search volume, and related SERP data as tracked by SpyFu.

## 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-02289df1/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)