# AgentWholesale Web Search

> AgentWholesale Web Search is a paid API for AI agents from agentwholesale.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Searches the live web and returns fresh, structured organic search results with titles, URLs, snippets, domains, and ranks for agent research.

## Facts

- Endpoint: POST https://agentwholesale.vercel.app/api/v1/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentwholesale-web-search-bed6851a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3TK5HLtPj_XloW-gv0IKt

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 agentwholesale-web-search-bed6851a -d '<json body>'
```

Example prompt: Search the live web for the top 10 results on 'AI regulation in the EU 2025' and give me the titles, URLs, and snippets — use US results.

## When to prefer this

Choose this endpoint when an agent needs live, current web search results with structured metadata (title, URL, snippet, domain, rank) rather than cached or static content. It is well-suited for research tasks, news retrieval, and competitive intelligence where freshness matters. At $0.01/call it is cost-effective for per-query agent workflows. Prefer it over scraping endpoints when you need ranked organic results across multiple sources rather than the full content of a single page.

## Known failure modes

- Empty query or query exceeding 700 characters returns a validation error
- Invalid country code (not two letters) causes a 400 error
- No results found for highly niche or misspelled queries may return an empty results array
- Rate limiting or service downtime may return 5xx errors
- Limit value outside 1–10 range triggers a schema validation error

## How this service works

Search the live web for current information. Returns fresh structured organic search results with titles, URLs, snippets, domains, and ranks for agent research and retrieval.

## Output

Returns a structured list of up to 10 organic search results, each containing the page title, URL, snippet/description text, domain name, and rank position — all reflecting live, current web index data at the time of the call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Optional number of organic results. Defaults to 10."
  },
  "query": {
   "type": "string",
   "maxLength": 700,
   "minLength": 1,
   "description": "Web search query."
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "description": "Optional two-letter country code. Defaults to US."
  }
 }
}
```

## More

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