# Zapper Search API

> Zapper Search API is a paid API for AI agents from public.zapper.xyz, paid per call via x402, $0.0045/call, status down (last checked 2026-09-15).

Search across ERC20 tokens, gas tokens, NFT collections, users, and apps on Zapper's blockchain data platform.

## Facts

- Endpoint: POST https://public.zapper.xyz/x402/search
- Price: $0.0045/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-zapper-xyz-103d90d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RRMslp_z6H75nxIFGLdJ0

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-zapper-xyz-103d90d0 -d '<json body>'
```

Example prompt: Search Zapper for anything matching 'USDC' — I want to see ERC20 tokens, NFT collections, users, and apps that come up.

## When to prefer this

Use this endpoint when you need a general-purpose cross-entity search across the Zapper ecosystem — covering tokens, NFTs, users, and apps in a single call. Prefer this over more specific portfolio or balance endpoints when you don't yet know the exact address or identifier of what you're looking for and need a discovery/search step first.

## Known failure modes

- Empty query returns no results or an error
- Misspelled or obscure names may return zero matches
- Rate limiting or payment failure (x402 payment not attached or insufficient USDC) returns 402 or 401
- Network or server error returns 5xx
- Ambiguous search terms may return unrelated results across entity types

## How this service works

Enterprise grade onchain data across 60+ chains - token prices, NFTs, portfolios, onchain search, Farcaster and more.

## Output

Returns a ranked list of matching entities across ERC20 tokens, gas tokens, NFT collections, users, and apps, with relevant metadata for each result type such as token symbols, collection names, user handles, and app identifiers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "search": {
   "type": "string",
   "description": "Search query (e.g., \"Ape\", \"eth\", \"Vitalik\"). Searches for token SYMBOLS, NFT collection names, ENS, and BaseNames."
  },
  "categories": {
   "type": "array",
   "items": {
    "enum": [
     "ERC20_TOKEN",
     "GAS_TOKEN",
     "NFT_COLLECTION",
     "USER",
     "APP"
    ],
    "type": "string"
   },
   "default": [
    "ERC20_TOKEN"
   ],
   "description": "Filter results by category. Use multiple categories for broader results (e.g., [\"GAS_TOKEN\", \"ERC20_TOKEN\"] for all token types). Defaults to ERC20_TOKEN only."
  },
  "maxResultsPerCategory": {
   "type": "integer",
   "default": 5,
   "description": "Limit results per category"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-zapper-xyz-103d90d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from public.zapper.xyz](https://www.zero.xyz/host/public.zapper.xyz/llms.txt)