# Soren Web Research

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

Performs a live web search and renders the top 3 results to clean markdown in a single paid API call, returning a researched answer faster and cheaper than doing each step separately.

## Facts

- Endpoint: GET https://soren.com/v1/web/research
- Price: $0.06/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-research-72870d78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kJflUG5oihC4CmoiI4S7M

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-research-72870d78
```

Example prompt: Research the current state of x402 payment protocol adoption — I need a real answer with actual page content, not just snippets.

## When to prefer this

Choose this endpoint when you need both search results AND the actual page content in one call, and want to minimize latency and cost versus chaining a search call and multiple page-fetch calls separately. Ideal for agents that need substantive, readable content from live web sources rather than just titles and snippets. Prefer over the sibling live-web-search endpoint when rendered page body text is required, not just result metadata.

## Known failure modes

- Search returns no results — call is free and returns a failure indicator
- All top pages fail to render — call is free since at least one must render to be charged
- Query exceeds 400 characters — request rejected before execution
- Page content exceeds 60KB cap — truncated at cap limit
- Target pages block rendering (e.g. heavy JavaScript or bot protection) — those pages listed as unrendered runners-up

## How this service works

A researched answer in ONE paid call: a live web search plus the top 3 results rendered to clean markdown. The single-call route costs four payments and four settlement waits; this is the same work in one payment, seconds faster and cheaper than the parts. Charged only if the search succeeds AND at least one page renders — a failed research costs nothing. Pages cap at 60KB each; unrendered runners-up are listed too.

## Output

Returns a researched answer combining live web search results with the top 3 matching pages rendered to clean markdown (capped at 60KB each). Also lists URLs of pages that were found but not rendered. The call is only charged if the search succeeds and at least one page renders successfully; failed research costs nothing.

## 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": "The question or topic to research. Up to 400 characters."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soren-web-research-72870d78/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)
