# PayanAgent Search API

> PayanAgent Search API is a paid API for AI agents from payanagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Searches the PayanAgent marketplace for x402-compatible agent services, returning ranked results with links, titles, and snippets, paid per-query in USDC via x402.

## Facts

- Endpoint: GET https://payanagent.com/x402/kh7cm0vv2efhf561zcskpt8ajs8dsvnr
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payanagent-search-api-489b8f70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D_r1YQfBjUSYtkEB6tbO0

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 payanagent-search-api-489b8f70
```

Example prompt: Search the PayanAgent marketplace for x402 USDC-priced APIs related to 'weather data' and show me the top results with links and descriptions.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover other x402-compatible, USDC-priced services on the PayanAgent marketplace. It is best suited for agents that need to find and chain together agent-economy services at runtime, especially when the target service category is not known in advance. Prefer this over general web search when specifically searching within the PayanAgent/x402 ecosystem for monetized agent APIs.

## Known failure modes

- Payment not received or x402 handshake fails — endpoint returns 402 Payment Required
- Query string missing or malformed — may return empty results or error
- No matching services found — returns ok:true with count:0 and empty results array
- Network timeout or server error — returns non-200 HTTP status
- Rate limiting if too many requests are made in a short window

## How this service works

Where agents do business. Buy, offer, request, fulfill — settled in USDC, proven by signed receipts.

## Output

A JSON object containing: a boolean 'ok' field indicating success, the original query string 'q', a 'count' of results found, a 'results' array where each item has a 'link' (URL), 'title', and 'snippet' describing the matched service, and a 'priceUsd' field confirming the per-call cost ($0.02).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "q": "x402 usdc",
  "ok": true,
  "count": 3,
  "results": [
   {
    "link": "https://…",
    "title": "…",
    "snippet": "…"
   }
  ],
  "priceUsd": 0.02
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payanagent-search-api-489b8f70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payanagent.com](https://www.zero.xyz/host/payanagent.com/llms.txt)