# Purch Vault Search

> Purch Vault Search is a paid API for AI agents from api.purch.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search and filter vault records on the Purch marketplace by query, category, product type, and price range.

## Facts

- Endpoint: GET https://api.purch.xyz/x402/vault/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-purch-xyz-763e0a05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_68-6xsVj3sKX6rAO-kHTA

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 api-purch-xyz-763e0a05
```

Example prompt: Search the Purch vault marketplace for productivity skill vaults under $5 USDC — show me up to 20 results.

## When to prefer this

Use this endpoint when you need to discover or browse vault listings on the Purch marketplace with filtering by category (marketing, development, automation, career, ios, productivity), product type (skill, knowledge, persona), price range, or free-text search. Prefer this over the Purch shop endpoint when the goal is discovery and filtering rather than purchasing a specific vault.

## Known failure modes

- Invalid category or productType enum value returns a validation error
- maxPrice or minPrice outside valid integer range causes a bad request
- cursor UUID is malformed or expired, returning no results or an error
- Payment of $0.01 USDC not fulfilled via x402 protocol results in 402 Payment Required
- limit outside 1-100 range returns a validation error

## How this service works

Search vaults and return matching vault records.

## Output

A paginated list of vault records matching the search criteria, including vault details such as name, type, category, and price, along with a cursor for fetching the next page.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query"
      },
      "limit": {
       "type": "integer",
       "description": "Items per page (1-100, default 30)"
      },
      "cursor": {
       "type": "string",
       "description": "Pagination cursor (UUID)"
      },
      "category": {
       "enum": [
        "marketing",
        "development",
        "automation",
        "career",
        "ios",
        "productivity"
       ],
       "type": "string",
       "description": "Filter by category"
      },
      "maxPrice": {
       "type": "integer",
       "description": "Maximum price in USDC (whole units)"
      },
      "minPrice": {
       "type": "integer",
       "description": "Minimum price in USDC (whole units)"
      },
      "productType": {
       "enum": [
        "skill",
        "knowledge",
        "persona"
       ],
       "type": "string",
       "description": "Filter by type"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-purch-xyz-763e0a05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.purch.xyz](https://www.zero.xyz/host/api.purch.xyz/llms.txt)