# Tavily Advanced Web Search

> Tavily Advanced Web Search is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Performs deep, advanced-mode web searches via Tavily with filtering by topic, domain, date range, and returns ranked results optionally with answers, images, and raw content

## Facts

- Endpoint: POST https://api.aidress.ai/pay/agent_x402_tavily_com
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tavily-advanced-web-search-1204f4b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uG6y_2RXofC3PtVZ5UiVR

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-1204f4b9 -d '<json body>'
```

Example prompt: Do an advanced Tavily search for 'Federal Reserve interest rate decision 2025' — search the news topic, limit to 10 results, include an AI-generated answer, and restrict to dates from 2025-01-01 to 2025-06-01.

## When to prefer this

Prefer this endpoint when you need advanced-depth web search with rich filtering options (topic, domain, date range), AI-generated answer synthesis, and optionally raw page content — particularly for news, finance, or general research use cases where standard search depth is insufficient. Choose over basic search when you need Tavily's advanced crawling mode specifically.

## Known failure modes

- Empty query or query exceeding 1000 characters returns validation error
- Invalid topic enum value causes schema rejection
- Date range with end_date before start_date may return zero results
- Domain filters that are too restrictive may return no matching results
- max_results out of range (below 1 or above 50) causes rejection
- Network timeout if Tavily upstream is slow
- Payment failure if USDC balance is insufficient

## How this service works

Tavily Search - advanced mode

## Output

Returns a list of ranked web search results (up to 50) including titles, URLs, content snippets, and optionally: an AI-synthesized answer to the query, raw page content, and images. Results are filtered by topic, domain, and date as specified.

## 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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tavily-advanced-web-search-1204f4b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)