# Public Data API – x402 Endpoint Recommender

> Public Data API – x402 Endpoint Recommender is a paid API for AI agents from x402-data-api-x6da.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-17).

Searches and ranks x402 pay-per-call API endpoints that match a natural language query, returning live-checked results with scores, prices, and descriptions

## Facts

- Endpoint: GET https://x402-data-api-x6da.onrender.com/v1/x402/recommend?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-data-api-x402-endpoint-recommender-ac3aeb92
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YM7sfD6ylq-CWGdijBrb0

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 public-data-api-x402-endpoint-recommender-ac3aeb92
```

Example prompt: Can you find me the best x402 pay-per-call API endpoint for converting web pages to markdown — show me up to 5 results with prices and live availability?

## When to prefer this

Use this endpoint when an AI agent needs to discover which x402 pay-per-call APIs exist for a given capability before committing to one. It is the meta-layer for x402 API discovery — prefer it over hardcoding a specific endpoint URL when the best available endpoint is unknown, prices need comparison, or live availability must be verified before spending USDC.

## Known failure modes

- No matching endpoints found for the query — returns empty results array
- Upstream listing sources (x402scan, the402) unavailable — may return cached or reduced results
- max_results out of 1-10 range — validation error
- Live 402 probe checks time out — check object may show errors > 0 or live_402: false
- Rate limiting or payment failure — 402 response requiring USDC on Base

## How this service works

Pay-per-call data and web utilities for AI agents: web page to Markdown, SEO audit, email check, domain RDAP/DNS and mail security, ECB FX rates, time zones and business days, SEC EDGAR search and fundamentals, Federal Register, USAspending, weather and NWS alerts, VIN, NPI, ATS jobs. USDC on Base via x402, no sign-up.

## Output

A JSON object containing the original query, extracted search terms, a list of ranked endpoint results (each with resource URL, description, price in USD, supported networks, live 402 check status, latency, HTTP status, error count, and a relevance score), the number of candidates evaluated, data sources used, and a timestamp. Results are ranked by score descending.

## 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": {
      "q": {
       "type": "string",
       "description": "what the agent needs, e.g. 'weather forecast'"
      },
      "max_results": {
       "type": "integer",
       "description": "1-10, default 5"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "note": {
       "type": "string"
      },
      "query": {
       "type": "string"
      },
      "terms": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "cached": {
       "type": "boolean"
      },
      "checked": {
       "type": "number"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "check": {
          "type": "object",
          "properties": {
           "errors": {
            "type": "number"
           },
           "live_402": {
            "type": "boolean"
           },
           "networks": {
            "type": "array",
            "items": {
             "type": "string"
            }
           },
           "price_usd": {
            "type": "number"
           },
           "latency_ms": {
            "type": "number"
           },
           "http_status": {
            "type": "number"
           }
          }
         },
         "score": {
          "type": "number"
         },
         "title": {},
         "networks": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "resource": {
          "type": "string"
         },
         "listed_in": {
          "type": "array",
          "items": {}
         },
         "price_usd": {
          "type": "number"
         },
         "description": {
          "type": "string"
         }
        }
       }
      },
      "sources": {
       "type": "array",
       "items": {
        "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Ranking from public listings plus our unpaid 402 checks; no endpoint was paid.",
  "query": "web page to markdown",
  "terms": [
   "web",
   "page",
   "markdown"
  ],
  "cached": false,
  "checked": 6,
  "results": [
   {
    "check": {
     "errors": 0,
     "live_402": true,
     "networks": [
      "base"
     ],
     "price_usd": 0.001,
     "latency_ms": 960,
     "http_status": 402
    },
    "score": 95,
    "title": null,
    "networks": [
     "base"
    ],
    "resource": "https://web.cyberwarex.com/fetch",
    "listed_in": [],
    "price_usd": 0.001,
    "description": "Read any live web page as clean, LLM-ready text. Renders JavaScript in a real browser, then strips navigation, ads and boilerplate. Use it when a plain HTTP GET returns empty or garbled HTML: single-page apps, dynamic feeds, or content that"
   },
   {
    "check": {
     "errors": 0,
     "live_402": true,
     "networks": [
      "base"
     ],
     "price_usd": 0.002,
     "latency_ms": 919,
     "http_status": 402
    },
    "score": 95,
    "title": null,
    "networks": [
     "base"
    ],
    "resource": "https://search.cyberwarex.com/contents",
    "listed_in": [],
    "price_usd": 0.002,
    "description": "Fetch one public web page and return its readable content as clean text or markdown, with JavaScript executed, so the result reads like the page a human sees. The retrieval half of research: pair it with /search to go from a query to ground"
   }
  ],
  "sources": [
   "x402scan public search",
   "the402 /api/listings"
  ],
  "checked_at": "2026-10-26T05:35:26Z",
  "candidates_seen": 500
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-data-api-x402-endpoint-recommender-ac3aeb92/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api-x6da.onrender.com](https://www.zero.xyz/host/x402-data-api-x6da.onrender.com/llms.txt)
