# SEO Competitor Comparison API

> SEO Competitor Comparison API is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0503/call, status unknown (last checked 2026-11-20).

Analyzes and compares the SEO/AEO technical scores of a target URL against up to 3 competitor URLs, returning graded subscores and actionable gap fixes.

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/seo-compare?utm_source=zero.xyz
- Price: $0.0503/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-competitor-comparison-api-e6f2e162
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IdlVd2OTaZAO0TUkn2w59

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-competitor-comparison-api-e6f2e162 -d '<json body>'
```

Example prompt: Compare the SEO of https://www.python.org/ against https://www.ruby-lang.org/en/ and https://www.perl.org/, focusing on keywords like 'programming language' and 'scripting', and tell me what gaps I need to fix to outrank them.

## When to prefer this

Choose this endpoint when you need a structured, quantitative SEO comparison between your site and specific known competitors, especially when you want actionable gap-fix recommendations broken down by category (technical, AEO, content, metadata, structured data). Prefer this over generic SEO audit tools when the goal is competitive benchmarking rather than a standalone site audit, and when you want per-check gap scoring rather than just a raw crawl or keyword rank check.

## Known failure modes

- Invalid or non-public URL returns an error or empty result
- Competitor URL array missing (minItems:1 not met) causes validation error
- URL behind authentication or bot protection may return incomplete scores
- HTTP 402 returned if payment not made via x402 before retry
- Rate limiting or timeout if target URLs are very slow to respond

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

Returns a JSON object with your site's SEO grade (A-F), numeric score (0-100), and subscores across AEO, content, metadata, technical, and structured data categories; competitor grades and subscores; and a prioritized list of gap items each including the check ID, category, how many points you'd gain, what competitors scored, and a concrete fix description.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2000,
   "description": "public http(s) URL"
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20
  },
  "competitor_urls": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 2000,
    "description": "public http(s) URL"
   },
   "maxItems": 3,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "you": {
   "url": "https://www.python.org/",
   "grade": "C",
   "score": 78,
   "reason": null,
   "final_url": "https://www.python.org/",
   "subscores": {
    "aeo": 73,
    "content": 90,
    "metadata": 62,
    "technical": 80,
    "structured_data": 83
   }
  },
  "gaps": [
   {
    "fix": "Use exactly one absolute, self-referencing canonical on the same host.",
    "max": 5,
    "yours": 0,
    "category": "technical",
    "check_id": "canonical",
    "gap_points": 5,
    "competitors": [
     5
    ]
   },
   {
    "fix": "Add a twitter:card type; X reuses your Open Graph tags for the rest.",
    "max": 2,
    "yours": 0,
    "category": "metadata",
    "check_id": "twitter_card",
    "gap_points": 2,
    "competitors": [
     2
    ]
   },
   {
    "fix": "Break content into question headings with short direct answers, or into lists/steps.",
    "max": 3,
    "yours": 2,
    "category": "aeo",
    "check_id": "qa_structure",
    "gap_points": 1,
    "competitors": [
     3
    ]
   }
  ],
  "skill": "seo_compare",
  "disclaimer": "Scores reflect technical checks only; no ranking or citation is guaranteed.",
  "competitors": [
   {
    "url": "https://www.ruby-lang.org/en/",
    "grade": "C",
    "score": 68.8,
    "reason": null,
    "final_url": "https://www.ruby-lang.org/en/",
    "subscores": {
     "aeo": 73,
     "content": 75,
     "metadata": 72,
     "technical": 100,
     "structured_data": 0
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-competitor-comparison-api-e6f2e162/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
