# uxus.finance Web Search API

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

Performs a web search and returns a ranked list of title, URL, and description results, indicating which provider (Serper, Brave, or DuckDuckGo) served them.

## Facts

- Endpoint: POST https://uxus.finance/api/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/uxus-finance-web-search-api-12fc256f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZsXA2F9nI4vOhV8Sd25Mi

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 uxus-finance-web-search-api-12fc256f -d '<json body>'
```

Example prompt: Search the web for 'best open-source LLM models in 2025' and give me the top results with their titles, URLs, and descriptions, plus which search provider returned them.

## When to prefer this

Choose this endpoint when you need web search results that include provider attribution (Serper, Brave, or DuckDuckGo), or when you want a pay-per-use search with no subscription required. Useful for agents that need to dynamically retrieve current web information without managing API keys for multiple search providers separately.

## Known failure modes

- Query string missing or empty — returns error
- Payment not processed — 402 response blocking access
- All three search providers unavailable — service error
- Query too long or malformed — parsing error
- Rate limit exceeded — throttling response

## How this service works

Live web search for AI agents — no API key, no account, no signup; pay per call in USDC on Base. GET ?q=YOUR+QUERY (required), count=N (1-20, default 10). Returns { query, results: [{ title, url, description, score }], provider, latency_ms }; score is 1.0 for the top result descending toward 0.1, so you can rank or threshold. Multiple search backends with automatic failover. For agents grounding an answer in current web data or gathering source URLs to scrape.

## Output

A ranked list of search result objects each containing a title, URL, and description snippet, plus a field indicating which search provider (Serper, Brave, or DuckDuckGo) served the results.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "x402 payment protocol",
  "results": [
   {
    "url": "https://x402.org/",
    "score": 1,
    "title": "x402 — Payment Required",
    "description": "An open standard for paying for HTTP requests with stablecoins."
   }
  ],
  "provider": "duckduckgo",
  "latency_ms": 480
 }
}
```

## More

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