# x402serps Competitor Report

> x402serps Competitor Report is a paid API for AI agents from x402serps.com, paid per call via x402, $0.3/call, status unknown (last checked 2026-11-16).

For a given domain and 1-8 keywords, returns a full SEO competitor analysis including rankings, share of voice, top competing domains, and advertisers

## Facts

- Endpoint: POST https://x402serps.com/api/v1/competitor-report?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-competitor-report-f4d6f9c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dZfzveZk4zvbQaTFvXwOi

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 x402serps-competitor-report-f4d6f9c7 -d '<json body>'
```

Example prompt: Run a competitor report for acmeshoes.com across the keywords 'running shoes', 'trail sneakers', and 'best athletic footwear' in the US market — I want to see who's outranking us, their share of voice, and which advertisers are showing up.

## When to prefer this

Choose this endpoint when you need a structured, multi-keyword SEO competitive landscape for a specific domain in one call — including share of voice, competitor rankings, and advertiser presence. It is superior to running individual SERP lookups when you need cross-keyword aggregation and competitive benchmarking in a single response. Prefer this over the AI/SEO visibility check when you need raw competitor data rather than AI-summarized brand visibility.

## Known failure modes

- Missing required 'domain' or 'keywords' fields returns a validation error
- More than 8 keywords in the array may be rejected or truncated
- Invalid country code in 'gl' may default to 'us' or return an error
- Payment failure via x402/USDC will block the request entirely
- Keywords with no Google results may return empty rank entries
- Domain not ranking for any keywords returns zeroed-out summary stats

## How this service works

Web search, news and page extraction for AI agents at $0.004 per search. Pay per call in USDC on Base or Solana via x402, or with card credits.

## Output

A JSON object containing: summary stats (average rank, share of voice, top competitor, keywords ranked/checked, keywords with ads); a per-keyword breakdown of your domain's URL, rank, and ad count; top-ranking pages for the domain; a list of advertiser domains; and a ranked list of competitor domains with their average rank, best rank, keyword count, and share of voice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gl": {
   "type": "string",
   "description": "Country code, default us"
  },
  "domain": {
   "type": "string",
   "description": "Your domain, e.g. example.com"
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "1-8 keywords"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "domain": "example.com",
  "competitors": [
   {
    "domain": "competitor.com",
    "shareOfVoice": 0.21
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402serps-competitor-report-f4d6f9c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402serps.com](https://www.zero.xyz/host/x402serps.com/llms.txt)
