# Tavily Advanced Web Search (x402)

> Tavily Advanced Web Search (x402) is a paid API for AI agents from x402.tavily.com, paid per call via x402, $0.01/call, status healthy (last checked 2026-10-11, last successful call 2026-10-01).

Performs advanced web search queries and returns ranked, relevant results with optional answers, images, and raw content via pay-per-call x402 protocol.

## Facts

- Endpoint: POST https://x402.tavily.com/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-11
- Last successful call: 2026-10-01
- Success rate: 100% of calls made through Zero
- Rating: 4.9 / 5 from 3 reviews
- Activations on Zero: 60
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tavily-advanced-web-search-x402-8e8022d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jPDo5MfaYzNptjZzxZJNy

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-advanced-web-search-x402-8e8022d0 -d '<json body>'
```

Example prompt: Search the web for the latest news about the Federal Reserve interest rate decision from this week — give me up to 10 results with a summarized answer, focusing on finance sources only.

## When to prefer this

Choose this endpoint when you need real-time or recent web search results with advanced filtering by topic, domain, or date — especially when you want an AI-synthesized answer alongside raw results. Prefer over generic search APIs when you need finance or news topic scoping, or when you need raw page content included in results. Ideal for agents that pay per call and need high-quality, relevance-ranked results without maintaining a search API subscription.

## Known failure modes

- Invalid or empty query returns validation error
- max_results out of range (must be 1-50 or 'auto') causes rejection
- Malformed date strings for start_date/end_date cause parse errors
- Payment failure via x402 protocol blocks request
- No results found for very niche or obscure queries returns empty results list
- Excluded and included domains conflict causing unexpected filtering

## How this service works

Tavily Search - advanced mode

## Output

Returns a list of relevant web search results (up to 50) including titles, URLs, snippets, and relevance scores. Optionally includes a synthesized answer to the query, images, and raw page content. Results can be scoped to general, news, or finance topics and filtered by domain or date range.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Search query (1-1000 chars)"
  },
  "topic": {
   "enum": [
    "general",
    "news",
    "finance"
   ],
   "type": "string"
  },
  "end_date": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  },
  "time_range": {
   "type": "string"
  },
  "max_results": {
   "oneOf": [
    {
     "const": "auto"
    },
    {
     "type": "integer",
     "maximum": 50,
     "minimum": 1
    }
   ],
   "description": "\"auto\" or integer 1-50"
  },
  "search_depth": {
   "enum": [
    "advanced"
   ],
   "type": "string",
   "default": "advanced"
  },
  "include_answer": {
   "type": "boolean"
  },
  "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": {
  "query": "what is x402?",
  "answer": null,
  "images": [],
  "results": [
   {
    "url": "https://x402.org/",
    "score": 0.92,
    "title": "x402 — Payment Required",
    "content": "x402 is an open payment protocol that revives the HTTP 402 status code so AI agents can pay per request in stablecoins, with no API keys or accounts.",
    "raw_content": null
   }
  ],
  "request_id": "8146b0d8-db42-42a7-8fb9-3796fce6853e",
  "response_time": 0.7,
  "follow_up_questions": null
 }
}
```

## More

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