# x402engine Web Search

> x402engine Web Search is a paid API for AI agents from x402engine.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Performs neural web search with highlighted snippets across articles, news, research, and general web content, returning ranked results with optional full-page text.

## Facts

- Endpoint: POST https://x402engine.app/api/search/web?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402engine-web-search-1052fd63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RNvTxMHRPYHzgofslXCli

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 x402engine-web-search-1052fd63 -d '<json body>'
```

Example prompt: Search the web for the latest Ethereum news and give me 10 results — filter to news category and include highlighted snippets.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call web search with category filtering (news, research papers, GitHub, tweets, PDFs) and optional domain restriction. It is ideal for AI agents that need real-time web information without a subscription, especially when the query is domain-specific or category-constrained. Prefer this over general-purpose search APIs when you want micropayment-based access without API key management.

## Known failure modes

- Empty query string returns a validation error
- numResults outside 1-30 range may be rejected or clamped
- Invalid category value may return no results or an error
- Restricted or unavailable domains in includeDomains may yield fewer results than requested
- Payment failure (HTTP 402) if USDC micropayment is not provided
- Very niche queries may return zero results

## How this service works

x402engine — Neural web search with highlighted snippets — find articles, news, research, and any web content

## Output

Returns a ranked list of web search results (up to 30), each containing the URL, title, and highlighted snippet of the matched content. Optionally includes full page text for deeper analysis. Results are filtered by category and/or domain when specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "example": "latest ethereum news",
       "description": "Search query"
      },
      "category": {
       "type": "string",
       "example": "news",
       "description": "Content category filter (news, research paper, company, tweet, github, pdf)"
      },
      "numResults": {
       "type": "number",
       "default": 10,
       "example": 10,
       "description": "Number of results (1-30)"
      },
      "includeText": {
       "type": "boolean",
       "default": false,
       "description": "Include full page text in results"
      },
      "includeDomains": {
       "type": "array",
       "items": {
        "type": "string",
        "example": "arxiv.org"
       },
       "example": [
        "arxiv.org",
        "github.com"
       ],
       "description": "Only include results from these domains"
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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