# PennyRegWatch Web Search

> PennyRegWatch Web Search is a paid API for AI agents from pennyregwatch.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Real-time web search returning ranked structured JSON results with title, URL, description, and position for AI agent grounding and research.

## Facts

- Endpoint: GET https://pennyregwatch.com/v1/search
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pennyregwatch-web-search-fb89980c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HgPmOt40IbUtsH7j4nWCx

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 pennyregwatch-web-search-fb89980c
```

Example prompt: Search the web right now for the latest news on the SEC's proposed crypto regulations and give me the top 5 results from the past week.

## When to prefer this

Choose this endpoint when an AI agent needs real-time, up-to-date web information beyond its training cutoff, especially for recent news, live facts, or current documentation. It is keyless and pay-per-call via x402, making it ideal for agentic pipelines that require no account setup. Prefer it over static knowledge bases when freshness is critical and over scraping tools when you need ranked, pre-structured results ready for RAG retrieval.

## Known failure modes

- Query parameter missing — returns 400 bad request
- Freshness enum value invalid — returns 400 or ignored
- Limit out of range (must be 1–10) — returns 400
- Payment not completed via x402 — returns 402 Payment Required
- No results found for query — returns empty results array
- Service downtime or upstream search provider failure — returns 5xx

## How this service works

Real-time web search for AI agents. Search the web for current and up-to-date information, news, facts, research, documentation, and sources beyond model training data. Returns ranked structured JSON results with title, URL, description, and position for web grounding, RAG retrieval, research, and fact-finding. Send query, optional limit, and optional freshness as URL parameters. Keyless x402 pay-per-call; no API key, account, or subscription required.

## Output

Returns a ranked JSON array of web search results, each containing a title, URL, description snippet, and integer position, ordered by relevance to the query.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 5,
       "maximum": 10,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "description": "Live web search query"
      },
      "freshness": {
       "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year"
       ],
       "type": "string",
       "description": "Optional freshness window"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tool": "penny_search",
  "count": 1,
  "query": "latest AI agent payment news",
  "results": [
   {
    "url": "https://example.com/article",
    "title": "Example result",
    "position": 1,
    "description": "A current ranked web result."
   }
  ],
  "freshness": "week",
  "latency_ms": 420,
  "retrieved_at": "2026-09-07T12:00:00+00:00"
 }
}
```

## More

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