# SEO Audit API v2 (x402 pay-per-call)

> SEO Audit API v2 (x402 pay-per-call) is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0497/call, status unknown (last checked 2026-11-17).

Fetches a public URL, runs a multi-category SEO audit, and returns a scored report with per-check findings, sub-scores, and prioritized fix recommendations.

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/seo-v2?utm_source=zero.xyz
- Price: $0.0497/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/seo-audit-api-v2-x402-pay-per-call-48d45343
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kjXKOdr5WG2YS5nGvKlli

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-audit-api-v2-x402-pay-per-call-48d45343 -d '<json body>'
```

Example prompt: Can you run a full SEO audit on https://www.myblog.com targeting the keywords 'python tutorials' and 'beginner programming', and give me a prioritized list of fixes?

## When to prefer this

Choose this endpoint when you need a detailed, structured, machine-readable SEO audit of a specific public URL with per-check granularity and actionable fix snippets — especially in a no-account, pay-per-call agent workflow using x402 on Base. Prefer it over traditional SEO SaaS tools when operating as an autonomous agent that cannot manage API keys or subscriptions, or when you need diff-based before/after comparisons via previous_report_id.

## Known failure modes

- HTTP 402 returned if payment is not included — must pay via x402 v2 USDC on Base then retry
- HTTP 400 if render_js is set to true (not yet available)
- Invalid or inaccessible URL returns an error
- URL exceeding 2000 characters is rejected
- keywords array exceeding 20 items is rejected
- Invalid previous_report_id returns diff error or is ignored

## 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

A JSON object containing: an overall SEO grade (letter) and numeric score (0–100), an array of individual check results each with id, category, pass/fail, points earned, evidence, severity, and an optional code fix snippet; category sub-scores (technical, content, metadata, structured_data, aeo); a top_fixes list ordered by impact; generated meta tag HTML suggestions; the final resolved URL; and a disclaimer noting scores are technical only.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2000,
   "description": "public http(s) URL"
  },
  "locale": {
   "type": "string",
   "default": "en"
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20
  },
  "render_js": {
   "type": "boolean",
   "default": false,
   "description": "not available yet; true is refused with 400 before payment"
  },
  "include_fixes": {
   "type": "boolean",
   "default": true
  },
  "previous_report_id": {
   "type": "string",
   "description": "report_id from an earlier run; adds a diff"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://www.python.org/",
  "grade": "C",
  "score": 77.7,
  "skill": "seo_v2",
  "checks": [
   {
    "id": "canonical",
    "fix": {
     "effort": "S",
     "snippet": "<link rel=\"canonical\" href=\"https://www.python.org/\">",
     "summary": "Use exactly one absolute, self-referencing canonical on the same host.",
     "snippet_lang": "html"
    },
    "max": 5,
    "pass": false,
    "points": 0,
    "category": "technical",
    "evidence": "no rel=canonical",
    "severity": "medium"
   },
   {
    "id": "h1",
    "fix": {
     "effort": "S",
     "snippet": "<h1>Functions Defined</h1>",
     "summary": "Use exactly one H1 that states the page topic in the same words as the title.",
     "snippet_lang": "html"
    },
    "max": 5,
    "pass": false,
    "points": 3,
    "category": "content",
    "evidence": "5 H1 elements",
    "severity": "medium"
   },
   {
    "id": "title",
    "fix": {
     "effort": "S",
     "snippet": "<title>Welcome to</title>",
     "summary": "Use one <title> of 30-60 characters that names the page topic.",
     "snippet_lang": "html"
    },
    "max": 6,
    "pass": false,
    "points": 3,
    "category": "metadata",
    "evidence": "title 21 chars: 'Welcome to Python.org'",
    "severity": "medium"
   }
  ],
  "reason": null,
  "version": "2.0",
  "final_url": "https://www.python.org/",
  "generated": {
   "meta_tags_html": "<title>Welcome to</title>\n<meta name=\"description\" content=\"Notice: This page displays a fallback because interactive scripts did not run.\">\n<link rel=\"canonical\" href=\"https://www.python.org/\">"
  },
  "subscores": {
   "aeo": 72,
   "content": 90,
   "metadata": 62,
   "technical": 80,
   "structured_data": 83
  },
  "top_fixes": [
   {
    "summary": "Use exactly one absolute, self-referencing canonical on the same host.",
    "check_id": "canonical",
    "impact_points": 5
   },
   {
    "summary": "Use one <title> of 30-60 characters that names the page topic.",
    "check_id": "title",
    "impact_points": 3
   },
   {
    "summary": "Write a 70-160 character meta description from the page's own text.",
    "check_id": "meta_description",
    "impact_points": 2.5
   }
  ],
  "disclaimer": "Scores reflect technical checks only; no ranking or citation is guaranteed."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/seo-audit-api-v2-x402-pay-per-call-48d45343/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)
