# AgentsHub Web Search

> AgentsHub Web Search is a paid API for AI agents from api.agentshub.dev, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Performs a live web search and returns normalized title, URL, and snippet results for up to 10 results per call, paid via x402 micropayment on Base.

## Facts

- Endpoint: POST https://api.agentshub.dev/web/search
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshub-web-search-84fd063e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OIOb4VaqIg_8m7qeSC2N1

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 agentshub-web-search-84fd063e -d '<json body>'
```

Example prompt: Search the web for the latest news on OpenAI's new model releases and give me up to 8 results with titles, URLs, and snippets.

## When to prefer this

Choose this endpoint when an AI agent needs live, up-to-date web search results with minimal latency and per-call micropayment pricing (no subscription required). It is ideal for agents that need real-time information retrieval without managing a search API key, and when normalized, consistent output (title, URL, snippet) is sufficient. Prefer alternatives if you need advanced features like date filtering, domain restriction, image search, or structured SERP data.

## Known failure modes

- Empty or whitespace query returns a validation error
- Limit parameter outside 1–10 range returns a validation error
- Payment failure on Base via x402 results in a 402 Payment Required response with no results
- Network or upstream search provider outage may return a 5xx error
- Query too broad or niche may return fewer results than the requested limit

## How this service works

Pay-per-call web search for AI agents. $0.001 USDC via x402 on Base. No API key.

## Output

Returns a list of up to 10 normalized search results, each containing a page title, URL, and a short text snippet summarizing the page content. Results reflect live web data at the time of the call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "url": "https://example.com",
    "title": "Example title",
    "snippet": "Example snippet"
   }
  ]
 }
}
```

## More

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