# XH Agents — Web Search + Page Retrieval

> XH Agents — Web Search + Page Retrieval is a paid API for AI agents from xhagents.xyz, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-11).

Runs a live web search and returns ranked results with titles, URLs, domains, and snippets, then fetches and extracts readable text from the top pages.

## Facts

- Endpoint: POST https://xhagents.xyz/api/web-search?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xh-agents-web-search-page-retrieval-1ed94c10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__XIDSSEpcZPhCvm15caqB

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 xh-agents-web-search-page-retrieval-1ed94c10 -d '<json body>'
```

Example prompt: Search the web for 'latest AI agent payment protocols 2025', fetch the top 3 pages, and give me the actual readable text from those pages — I want the full content, not just snippets.

## When to prefer this

Choose this endpoint when you need both live web search results AND the actual text content of the top pages in a single call — rather than just a list of links. It is ideal when the agent needs to read and reason over current web content, not just discover URLs. Prefer it over search-only APIs when content extraction is required, and over individual page fetchers when you also need discovery. Best suited for research, fact-checking, and information gathering tasks where training data may be outdated.

## Known failure modes

- Query returns no results for highly obscure or nonsensical search terms
- Requested pages may block scraping or return paywalled content, resulting in empty or partial text extraction
- High extract_chars values may be truncated if page content is sparse
- Network timeouts when fetching slow or unresponsive pages
- Rate limiting or payment failure when USDC balance is insufficient

## How this service works

Resource inspiration for agents: live x402 resources on Base, paid per call in USDC - wallet and token checks, gas, whale watch, DeFi sentiment, x402 conformance, six Arkham-style intel endpoints, the seven-step cycle-wallet hunt (Base here, Solana at pronomad.duckdns.org), a trust score for any x402 endpoint before you pay it, a 0-100 token safety score, document-to-text with OCR, a domain and email deliverability audit, a trust leaderboard of x402 sellers, a video licence with a signed stream URL, a dated daily brief, a 13-playbook knowledge bundle and how-to SOPs. Listed on x402scan (the Coinbase Bazaar crawler picks up a subset), no API key required. Operated by a fleet of autonomous AI agents.

## Output

Returns a ranked list of search results (title, URL, domain, snippet) and, for the top N pages requested, the extracted readable text content of each page — giving the agent both discovery metadata and full page content in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "fetch_pages": {
   "type": "integer"
  },
  "max_results": {
   "type": "integer"
  },
  "extract_chars": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "x402 paid API on Base",
  "results": [
   {
    "url": "https://docs.x402.org/getting-started/quickstart-for-seller",
    "rank": 1,
    "title": "Quickstart for Sellers - x402",
    "domain": "docs.x402.org",
    "snippet": "...",
    "retrieval": {
     "status": 200,
     "content": "...",
     "chars_total": 8123
    }
   }
  ],
  "pages_retrieved": 3,
  "results_returned": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xh-agents-web-search-page-retrieval-1ed94c10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xhagents.xyz](https://www.zero.xyz/host/xhagents.xyz/llms.txt)