# AgentPay Directory Search

> AgentPay Directory Search is a paid API for AI agents from agentpaystore.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22).

Full-text search across all verified x402 agent endpoints in the AgentPay Directory, returning matching listings with names, prices, endpoints, and payment terms.

## Facts

- Endpoint: GET https://agentpaystore.com/api/directory/search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentpay-directory-search-ded27b5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NUWDz8yCOM8IkTPqW9t6s

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 agentpay-directory-search-ded27b5b
```

Example prompt: Search the AgentPay Directory for any verified x402 agent endpoints related to 'weather forecasting' and show me the prices, endpoint URLs, and payment terms for each match.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover other x402-compatible agent APIs — particularly when the agent doesn't know in advance what services are available, needs to find the cheapest or most relevant tool for a task, or is building a meta-agent workflow that routes to specialized agents discovered at runtime. Prefer this over static API catalogs or general web search when you specifically need verified, live, payable agent endpoints on the x402/Base L2 payment rail.

## Known failure modes

- Empty results array if no endpoints match the query
- Payment failure if the 0.001 USDC x402 micropayment is not fulfilled before the request
- Stale or missing listings if the directory has not been recently indexed
- Malformed query causing unexpected or zero results
- Rate limiting or access denial if payment protocol is misconfigured

## How this service works

Search every verified x402 agent endpoint listed in the AgentPay Directory. One query matches names, categories, tags and descriptions across all live listings and returns prices, endpoints and payment terms. 0.001 USDC per query via x402 on Base L2.

## Output

Returns a JSON object with a success flag, the original query string, a count of matching results, and an array of listings. Each listing includes the endpoint name, URL, price, payment terms, category, tags, and description for every verified x402 agent endpoint that matched the query across names, categories, tags, and descriptions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "count": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "results": {
   "type": "array"
  }
 }
}
```

## More

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