# HivemindOS Web Search

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

Searches the independent HivemindOS web index and returns up to 20 results with title, URL, snippet, and publication date for a given query.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/web-data/web.search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-web-search-910a2564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qk42v1hYAKOh59o-g-sd7

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 hivemindos-web-search-910a2564 -d '<json body>'
```

Example prompt: Search the web for the latest news on quantum computing breakthroughs — give me up to 10 results from the past week, focused on English-language US sources.

## When to prefer this

Use this endpoint when an agent needs live web search results without possessing its own search API key, and when access to an independent index (not Google/Bing) is acceptable or preferred. It is well-suited for citation gathering, fact-checking with fresh sources, and grounding LLM responses in real web content. Prefer it when freshness filtering by day, week, month, or year is needed and when per-call micropayment pricing via USDC on Base is acceptable.

## Known failure modes

- Query too long (over 500 characters) returns a validation error
- Unsupported country or language code returns an error or empty results
- Freshness filter yields zero results if no pages indexed in that window
- Limit out of range (below 1 or above 20) returns a validation error
- Payment failure on x402 protocol means no results returned and no charge

## How this service works

Search the web: pages from across the web for a search, each with its title, address, a snippet and when it was published, from an independent index. Use it to find pages to read or cite. Use when an agent needs fresh web results to ground an answer, find sources to cite or pages to read, without a search API key of its own. $0.01 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A list of up to 20 web results, each containing the page title, URL, a text snippet, and the publication date — drawn from HivemindOS's independent web index, not Google or Bing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1,
   "description": "How many results, up to 20."
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "The search to run."
  },
  "country": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Two-letter country code, such as us or gb. Defaults to us."
  },
  "language": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Two-letter language code, such as en."
  },
  "freshness": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Only recent pages: pd for the past day, pw the past week, pm the past month, py the past year."
  }
 }
}
```

## More

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