# SpyFu SERP - Get Where They Just Surpassed You

> SpyFu SERP - Get Where They Just Surpassed You 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-16).

Returns SEO keywords where a competitor domain recently overtook your domain in search rankings

## Facts

- Endpoint: GET https://spyfu.x402.paysponge.com/apis/serp_api/v2/seo/getWhereTheyJustSurpassedYou
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spyfu-8226d2d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vah4DQgAsDWpz-jLeRUtH

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-8226d2d4
```

Example prompt: Show me the keywords where competitor site acmecorp.com just recently surpassed mysite.com in organic Google search rankings — I want to see where they've newly overtaken us.

## When to prefer this

Use this endpoint when you specifically need to identify keywords where a competitor has freshly overtaken your domain in organic search rankings — i.e., recent rank changes favoring the competitor. Prefer this over getWhereTheyOutRankYou (which shows all keywords where they outrank you) when you want to focus on newly lost positions rather than the full competitive gap.

## Known failure modes

- Missing required query parameters returns a 400 error
- Unknown or unrecognized domains may return empty result sets
- Payment failure via x402 protocol returns 402 Payment Required
- Rate limiting may return 429 Too Many Requests
- Domains with no overlapping keyword history may return no results

## How this service works

GET /apis/serp_api/v2/seo/getWhereTheyJustSurpassedYou

## Output

A list of SEO keywords on which the specified competitor domain has recently moved above the queried domain in organic search rankings, including keyword terms and relevant ranking position data.

## 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-8226d2d4/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)