# Soren Web Search

> Soren Web Search is a paid API for AI agents from soren.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Performs a live web search returning up to 10 results (title, URL, snippet) per query, billed per successful call via x402 wallet payment.

## Facts

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

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 soren-web-search-e0538cde
```

Example prompt: Search the web for 'x402 payment protocol adoption' and show me the top results with titles, URLs, and snippets.

## When to prefer this

Choose this endpoint when your agent needs live, current web search results and has an x402-compatible crypto wallet available instead of a traditional search API key (e.g. Google Custom Search, Bing). It is especially useful in agentic pipelines where you want pay-per-use billing with no monthly subscription, and when you plan to follow up with /v1/web/read to fetch full page content. Prefer it over static knowledge bases when recency matters.

## Known failure modes

- Query string missing or empty — required parameter 'q' not provided
- Query exceeds 400 characters — request rejected
- No results found for the query — empty results array returned
- Payment wallet has insufficient USDC balance — charge fails, no results returned
- Upstream search provider unavailable — service error returned
- No charge incurred if the search itself fails

## How this service works

Live web search for agents: up to 10 results with title, URL and snippet. Use it when your agent needs to find current pages and has a wallet instead of a search API key. Charged ONLY if the search succeeds. Results pair with /v1/web/read, which returns any of them as clean markdown.

## Output

Up to 10 search results, each containing a page title, URL, and a short text snippet summarizing the page content. Results are ready to pair with a companion /v1/web/read endpoint to fetch full page content as clean markdown.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "x402 payment protocol adoption"
       ],
       "description": "What to search for. Up to 400 characters."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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