# Tavily Web Search via Locus x402

> Tavily Web Search via Locus x402 is a paid API for AI agents from tavily.x402.paywithlocus.com, paid per call via x402, $0.09/call, status unknown (last checked 2026-10-10).

Performs AI-optimized web search with configurable depth, topic filtering, and optional AI-generated answer summaries, billed via x402 micropayment.

## Facts

- Endpoint: POST https://tavily.x402.paywithlocus.com/tavily/search?utm_source=zero.xyz
- Price: $0.09/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tavily-web-search-via-locus-x402-2a003c68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ODpIYL7UUe9VC3OdkI8v4

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 tavily-web-search-via-locus-x402-2a003c68 -d '<json body>'
```

Example prompt: Search the web for the latest developments in quantum computing from the last 7 days, give me up to 10 results with an AI-generated answer summary, using advanced search depth and focusing on news.

## When to prefer this

Choose this endpoint when you need AI-optimized, up-to-date web search with fine-grained control over recency, domain inclusion/exclusion, country targeting, and search depth — especially when you want an AI-generated answer summary alongside raw results. Prefer it over generic search APIs when the agent needs Tavily's ranking quality and the convenience of x402 micropayment billing without managing API keys separately.

## Known failure modes

- Empty or vague query returns low-relevance results
- Overly restrictive domain filters may return zero results
- 'days' filter set too narrow may exclude all recent content
- Advanced search depth may increase latency slightly
- Invalid country code may fall back to default or return error
- Payment failure via x402 will block the request from completing

## How this service works

Locus public pay-per-use API

## Output

Returns a JSON object containing an array of search results (each with URL, title, and snippet), optionally an AI-generated answer summarizing the results, optionally related images, optionally raw HTML content, plus payment settlement details (amount in USDC) and a request ID for status tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "number"
  },
  "query": {
   "type": "string"
  },
  "topic": {
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "max_results": {
   "type": "number"
  },
  "search_depth": {
   "type": "string"
  },
  "include_answer": {
   "anyOf": [
    {
     "type": "boolean"
    },
    {
     "type": "string"
    }
   ]
  },
  "include_images": {
   "type": "boolean"
  },
  "exclude_domains": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "include_domains": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "include_raw_content": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tavily-web-search-via-locus-x402-2a003c68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tavily.x402.paywithlocus.com](https://www.zero.xyz/host/tavily.x402.paywithlocus.com/llms.txt)