# 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-14).

Performs a web search query and returns results via a paid x402 micropayment-gated API endpoint

## Facts

- Endpoint: POST https://pennyrail.vercel.app/api/p/premium/web.search--search
- 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/pennyrail-web-search-1fd19f77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1d0kKJUyW9AbfDA1Y_Dhd

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-1fd19f77 -d '<json body>'
```

Example prompt: Search the web for the latest news about renewable energy breakthroughs in 2024 and give me the top results.

## When to prefer this

Choose this endpoint when an agent needs live, up-to-date web search results that are beyond its training data cutoff. It is suitable for retrieving current news, verifying recent facts, or discovering URLs about any topic. Prefer this over static knowledge bases when freshness is critical. The x402 micropayment model at $0.02 per call makes it cost-effective for moderate query volumes without subscription commitments.

## Known failure modes

- Insufficient USDC payment or failed x402 micropayment — returns 402 Payment Required
- Malformed input object missing required fields — returns 400 Bad Request
- Query too vague or empty — may return empty result set
- Rate limiting or service unavailability on Vercel infrastructure — returns 503
- Upstream search provider outage — may return partial or no results

## How this service works

Machine-readable settlement service

## Output

Returns a JSON object containing web search results, typically including page titles, URLs, and descriptive snippets relevant to the query, sourced from live web index data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pennyrail-web-search-1fd19f77/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)