# PennyRail Web Search

> PennyRail Web Search is a paid API for AI agents from pennyrail.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Performs a live web search and returns a grounded answer with cited sources, paid per-query via $0.02 USDC on Base.

## Facts

- Endpoint: POST https://pennyrail.vercel.app/api/bazaar/web-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pennyrail-web-search-96fa539e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w7XKl3cHYglB_DF3MoNgX

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 pennyrail-web-search-96fa539e -d '<json body>'
```

Example prompt: Search the web for the latest developments in quantum computing and give me a grounded answer with sources — up to 5 results, published in the past month.

## When to prefer this

Choose this endpoint when an AI agent needs real-time, grounded web search results with source citations at a low per-query cost ($0.02 USDC). Ideal for agents that need to answer questions about current events, recent publications, or live information not present in training data. The x402 micropayment model makes it suitable for pay-per-use agent pipelines without subscriptions.

## Known failure modes

- Payment failure if wallet lacks sufficient USDC on Base
- Query too short or empty (minLength:1 not met)
- No relevant results found for obscure or very niche queries
- Freshness filter too narrow yields zero results
- Country filter restricts results unexpectedly
- Rate limits or service unavailability from underlying search provider

## How this service works

Live web search for AI agents. Pay $0.02 USDC on Base and receive a grounded answer plus sources.

## Output

A grounded natural-language answer derived from live web results, accompanied by source URLs and citations supporting the response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "minLength": 1,
   "description": "Alias for query."
  },
  "count": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Natural-language web search query."
  },
  "country": {
   "type": "string"
  },
  "freshness": {
   "enum": [
    "pd",
    "pw",
    "pm",
    "py"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pennyrail-web-search-96fa539e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pennyrail.vercel.app](https://www.zero.xyz/host/pennyrail.vercel.app/llms.txt)