# TokenGuard Web Search

> TokenGuard Web Search is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Performs a web search query using DuckDuckGo and returns ranked results with titles, URLs, and snippets

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/web/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-web-search-48324f57
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ffrYryTfTRIEsCgsl9vVp

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 tokenguard-web-search-48324f57 -d '<json body>'
```

Example prompt: Search the web for 'x402 protocol micropayment spec' and give me the top 10 results with titles, URLs, and snippets.

## When to prefer this

Choose this endpoint when you need quick web search results within a crypto/DeFi-focused agent context and want to pay per-call with x402 micropayments rather than managing a subscription API key. Prefer this over general search APIs when your agent is already integrated with the TokenGuard x402 payment flow on Base. Note that the underlying engine is DuckDuckGo, so expect privacy-respecting results without personalization.

## Known failure modes

- Empty results if the query is too obscure or misspelled
- Payment failure (402) if USDC balance is insufficient for the $0.01 micropayment
- Rate limiting if too many requests are sent in quick succession
- DuckDuckGo backend timeout returning an empty results array
- Malformed query string causing a 400 bad request error

## How this service works

Web search for agents: a query returns ranked title/url/snippet results (no API key, no signup)

## Output

Returns a JSON object containing the total result count, the original query string, the search engine used (duckduckgo), and an array of result objects each with a URL, rank integer, page title, and a text snippet summarizing the page content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Search query"
  },
  "max_results": {
   "type": "integer",
   "description": "1-25 results (default 10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "query": "x402 protocol spec",
  "engine": "duckduckgo",
  "results": [
   {
    "url": "https://example.com/spec",
    "rank": 1,
    "title": "x402 spec",
    "snippet": "The x402 protocol defines…"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-web-search-48324f57/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)