# Agent Utility Suite – Web Search

> Agent Utility Suite – Web Search is a paid API for AI agents from x402-agent-api.onrender.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-13).

Performs a web search and returns ranked results with titles, snippets, and URLs, optionally filtered by country, language, and time range.

## Facts

- Endpoint: POST https://x402-agent-api.onrender.com/api/v1/web-search?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-utility-suite-web-search-285a3780
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1ySVjBVRW9KHgQERA1L4d

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 agent-utility-suite-web-search-285a3780 -d '<json body>'
```

Example prompt: Search the web for 'best open-source vector databases 2025' and give me the top 8 results from the past year.

## When to prefer this

Choose this endpoint when you need live, ranked web search results with snippets and URLs — especially when you want to filter by recency (day/week/month/year), locale, or language. Prefer it over static knowledge or SEC-specific endpoints when the query spans general web content, news, or third-party commentary. It is particularly useful for chaining: use it to discover URLs and then pass those to the web-to-Markdown endpoint for full content extraction.

## Known failure modes

- Empty results if query is too niche or misspelled
- Truncated snippets for paywalled or thin-content pages
- No date returned for pages without structured date metadata
- Rate limiting or 402 payment failure if USDC balance is insufficient
- Time range filter may return fewer results than requested if little recent content exists
- Country/language filter may be ignored by provider for certain queries

## How this service works

Web search for agents: ranked results (title, URL, snippet, date), a direct answer when available and related searches, with country, language and recency filters. Not charged when there are no results. $0.006 USDC per call.

## Output

A JSON object containing the count of results, the original query, an optional direct answer, a list of ranked results each with URL, title, snippet, date, and position, a provider field (serper), related search suggestions, and next_calls hints for chaining with other endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "num": {
   "type": "integer",
   "default": 8,
   "maximum": 10,
   "minimum": 1,
   "description": "How many results (1-10, default 8)."
  },
  "via": {
   "type": "string",
   "maxLength": 64,
   "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
  },
  "query": {
   "type": "string",
   "maxLength": 400,
   "minLength": 1,
   "description": "What to search for, e.g. \"best open-source vector database 2026\" or \"site:sec.gov Apple 10-K\"."
  },
  "country": {
   "type": "string",
   "pattern": "^[a-z]{2}$",
   "description": "Two-letter country for local results, e.g. us, gb, de. Default: us."
  },
  "language": {
   "type": "string",
   "pattern": "^[a-z]{2}$",
   "description": "Two-letter language code, e.g. en, de, fr."
  },
  "time_range": {
   "enum": [
    "day",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "description": "Only results from the past day, week, month or year (news, recent events)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "x402 payment protocol",
  "answer": null,
  "results": [
   {
    "url": "https://www.x402.org/",
    "date": null,
    "title": "x402 - Payments for the internet",
    "snippet": "An open protocol for internet-native payments...",
    "position": 1
   }
  ],
  "provider": "serper",
  "next_calls": [],
  "related_searches": [
   "x402 coinbase"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-utility-suite-web-search-285a3780/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-api.onrender.com](https://www.zero.xyz/host/x402-agent-api.onrender.com/llms.txt)