# Echo Router – Tavily Web Search

> Echo Router – Tavily Web Search is a paid API for AI agents from echo.router.merit.systems, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Performs web searches via Tavily's search API, returning ranked results with content snippets, scores, and optional AI-generated answers.

## Facts

- Endpoint: POST https://echo.router.merit.systems/resource/tavily/search
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/echo-router-tavily-web-search-d904e19a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9fIMUekzzGz6KkqflOGHp

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 echo-router-tavily-web-search-d904e19a -d '<json body>'
```

Example prompt: Search the web for the latest news about OpenAI's GPT-5 release — do a deep search, include an AI-generated answer, limit to 10 results from the last 7 days, and focus on the 'news' topic.

## When to prefer this

Choose this endpoint when you need live, up-to-date web search results with relevance scoring and optional AI-synthesized answers. Prefer it over static knowledge bases when recency matters, or when you need to search within specific domains, countries, or date windows. It is especially useful for news research, fact-checking with sources, or any task requiring current information beyond a model's training cutoff.

## Known failure modes

- Empty or vague query returns low-quality or no results
- Invalid date range or malformed start_date/end_date causes parameter error
- Unsupported topic or search_depth value may cause API rejection
- Rate limiting or quota exhaustion from Tavily upstream returns error
- Network timeout if Tavily API is slow, especially with include_raw_content enabled
- Payment failure (402) if USDC balance is insufficient

## How this service works

Performs web searches using Tavily's search API. Returns relevant search results with content snippets and metadata for research and information retrieval.

## Output

A list of ranked search results each containing title, URL, content snippet, relevance score, and optional raw content; plus an optional AI-generated answer summarizing findings, any matched images, and metadata including request ID and response time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "topic": {
   "enum": [
    "general",
    "news"
   ],
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "end_date": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  },
  "time_range": {
   "type": "string"
  },
  "max_results": {
   "type": "integer"
  },
  "search_depth": {
   "enum": [
    "basic",
    "advanced"
   ],
   "type": "string"
  },
  "include_answer": {
   "type": "boolean"
  },
  "include_images": {
   "type": "boolean"
  },
  "auto_parameters": {
   "type": "boolean"
  },
  "exclude_domains": {
   "type": "array"
  },
  "include_domains": {
   "type": "array"
  },
  "include_favicon": {
   "type": "boolean"
  },
  "chunks_per_source": {
   "type": "integer"
  },
  "include_raw_content": {
   "type": "boolean"
  },
  "include_image_descriptions": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "query": {
  "type": "string"
 },
 "answer": {
  "type": "string",
  "nullable": true
 },
 "images": {
  "type": "array",
  "items": {
   "type": "string"
  }
 },
 "results": {
  "type": "array",
  "items": {
   "type": "object",
   "required": [
    "title",
    "url",
    "content",
    "score",
    "raw_content"
   ],
   "properties": {
    "url": {
     "type": "string"
    },
    "score": {
     "type": "number"
    },
    "title": {
     "type": "string"
    },
    "content": {
     "type": "string"
    },
    "favicon": {
     "type": "string"
    },
    "raw_content": {
     "type": "string",
     "nullable": true
    }
   },
   "additionalProperties": false
  }
 },
 "request_id": {
  "type": "string"
 },
 "response_time": {
  "type": "number"
 },
 "auto_parameters": {
  "type": "object",
  "properties": {
   "topic": {},
   "search_depth": {}
  },
  "additionalProperties": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/echo-router-tavily-web-search-d904e19a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from echo.router.merit.systems](https://www.zero.xyz/host/echo.router.merit.systems/llms.txt)