# AgentToll x402 Rank Audit

> AgentToll x402 Rank Audit is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Audits the search-engine ranking visibility of keywords or URLs and returns a verdict on how visible they are, along with ranked keyword counts and recommendations.

## Facts

- Endpoint: POST https://agenttoll.dev/paid/x402/rank-audit
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-x402-rank-audit-2db38279
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MsOVhhXlrCHilhOuCinyX

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 agenttoll-x402-rank-audit-2db38279 -d '<json body>'
```

Example prompt: Can you do a rank audit on https://example.com and tell me how many of my target keywords are actually showing up in search results and whether the page is fully visible, partially visible, or not visible at all?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call SEO rank audit without a subscription to a traditional SEO platform. It is ideal for AI agents that need on-demand keyword visibility verdicts for arbitrary URLs, especially within automated workflows where x402 micropayments in USDC are already supported. Prefer it over full-suite SEO platforms when you need a single-call audit result rather than ongoing monitoring.

## Known failure modes

- Invalid or unreachable URL returns an error or empty audit result
- Payment failure (insufficient USDC balance) results in HTTP 402 and no audit data returned
- Unsupported domain or blocked robots.txt may yield a 'not_visible' verdict with no ranked keywords
- Malformed request body returns a validation error
- Rate limiting or overload may result in timeout or 5xx error

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object with a product label ('x402 Rank Audit'), a summary object containing a visibility verdict (e.g. 'partially_visible', 'fully_visible', 'not_visible') and a count of ranked keywords found, plus an array of recommendations for improving ranking visibility.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "resource": {
       "type": "string",
       "maxLength": 500
      },
      "keywords": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "maxItems": 8
      },
      "limit": {
       "type": "integer",
       "minimum": 5,
       "maximum": 25
      }
     }
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": "x402 Rank Audit",
  "summary": {
   "verdict": "partially_visible",
   "ranked_keywords": 2
  },
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-x402-rank-audit-2db38279/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)