# OnlyBots Web & News Search

> OnlyBots Web & News Search is a paid API for AI agents from x402.onlybots.shop, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Performs web or news search given a query string and returns ranked results (title, URL, snippet) as clean JSON, paid per-call via x402 with no API key required.

## Facts

- Endpoint: GET https://x402.onlybots.shop/search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onlybots-web-news-search-7590dc66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BXaMw9plvwkq7MwE9lzRd

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 onlybots-web-news-search-7590dc66
```

Example prompt: Search the web for 'x402 payment protocol' and give me the top 10 results — titles, URLs, and snippets.

## When to prefer this

Prefer this endpoint when you need keyless, account-free web or news search with clean JSON output and per-call micropayment pricing via x402/USDC. Ideal for agent workflows that require flexible, on-demand search without committing to a monthly API subscription or managing OAuth credentials. Use when cost-per-call transparency matters and you want both web and news search from a single endpoint.

## Known failure modes

- Payment failure via x402 if wallet balance is insufficient or payment header is missing/malformed
- Empty results array if the query matches nothing in the index
- Invalid `type` parameter value (must be 'text' or 'news') returns an error
- Missing required `q` parameter returns a validation error
- Result count `n` outside 1–20 range may be clamped or return an error

## How this service works

Web search for AI agents: query in, ranked results out (title, URL, snippet) as clean JSON. Sovereign metasearch — no API key, no upstream account. Also does news search (type=news). Priced to undercut the incumbents.

## Output

A JSON object containing the query string, result count, and an array of ranked results, each with a title, URL, and snippet text. Typically 1–20 results depending on the `n` parameter (default 8).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "n": {
       "type": "string",
       "description": "max results 1-20 (default 8)"
      },
      "q": {
       "type": "string",
       "description": "search query"
      },
      "type": {
       "type": "string",
       "description": "text (default) or news"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 8,
  "query": "x402 payment protocol",
  "results": [
   {
    "url": "https://x402.org/",
    "title": "x402",
    "snippet": "…"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onlybots-web-news-search-7590dc66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.onlybots.shop](https://www.zero.xyz/host/x402.onlybots.shop/llms.txt)