# Nodely Search

> Nodely Search is a paid API for AI agents from x402.api.nodely.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-31).

Fan-out web search across 4 engines via SearXNG, returning merged and ranked results as JSON, NDJSON, or SSE stream

## Facts

- Endpoint: POST https://x402.api.nodely.io/v1/search?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nodely-search-bd81c5a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Ma4P12Op56TaQuNLBvLy

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 nodely-search-bd81c5a1 -d '<json body>'
```

Example prompt: Search the web for the latest developments in quantum computing — use deep depth, limit to 20 results from the past month, general topic, and stream the results back to me.

## When to prefer this

Choose Nodely Search when you need multi-engine web search results aggregated and ranked in a single call, especially when you want domain inclusion/exclusion filtering, date-range control, language/country localization, or real-time streaming output. It is superior to single-engine search APIs for breadth of coverage and when cross-referencing multiple sources matters. Prefer it over a scraping endpoint (like Nodely Scrape) when you need to discover and rank relevant URLs rather than extract content from a known URL.

## Known failure modes

- Query exceeds 400-character limit — returns validation error
- No results found for highly specific or obscure queries
- Engine availability issues may reduce result diversity if one or more of the 4 engines is unreachable
- Date range filters may exclude relevant results if set too narrowly
- Streaming (SSE) connection may drop for slow clients
- Payment not fulfilled (x402) — request blocked without USDC payment
- Invalid engine name in 'engines' array — may silently ignore unknown engines

## How this service works

Web search: one query fanned out to 4 search engines (alpha, gamma, delta, epsilon) via SearXNG, merged and ranked; JSON, NDJSON or SSE stream.

## Output

A merged and ranked list of web search results aggregated from up to 4 search engines, returned as JSON (default), NDJSON, or a real-time SSE stream. Each result typically includes the page title, URL, and a description snippet. When include_answer is true, a synthesized answer may be prepended. Results can be paginated and filtered by domain, language, country, date range, and safesearch level.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "depth": {
   "enum": [
    "standard",
    "deep"
   ],
   "type": "string"
  },
  "query": {
   "type": "string",
   "maxLength": 400,
   "minLength": 1
  },
  "topic": {
   "enum": [
    "general",
    "news"
   ],
   "type": "string"
  },
  "stream": {
   "type": "boolean"
  },
  "country": {
   "type": "string"
  },
  "engines": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "end_date": {
   "type": "string",
   "format": "date"
  },
  "language": {
   "type": "string"
  },
  "safesearch": {
   "enum": [
    0,
    1,
    2
   ],
   "type": "integer"
  },
  "start_date": {
   "type": "string",
   "format": "date"
  },
  "time_range": {
   "enum": [
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string"
  },
  "max_results": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "include_answer": {
   "type": "boolean"
  },
  "exclude_domains": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "include_domains": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nodely-search-bd81c5a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.api.nodely.io](https://www.zero.xyz/host/x402.api.nodely.io/llms.txt)