# Tavily AI-Native Web Search (via vaaya.ai)

> Tavily AI-Native Web Search (via vaaya.ai) is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Performs AI-tuned web search optimized for RAG pipelines, returning ranked results with relevance scores and optional LLM-synthesized answers.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/tavily/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tavily-ai-native-web-search-via-vaaya-ai-4ae214db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J0yj8rlv9TIwGU3GWk0jv

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-ai-native-web-search-via-vaaya-ai-4ae214db -d '<json body>'
```

Example prompt: Search the web for the latest news on OpenAI's GPT-5 release from the past week, return up to 10 ranked results with relevance scores and a synthesized answer summarizing what you find.

## When to prefer this

Choose Tavily search when you need RAG-optimized web search with built-in relevance scoring and optional LLM answer synthesis — especially useful when you want to combine retrieval with answer generation in one call. Prefer over Exa when you need keyword-based recency-weighted results rather than semantic recall, and over Brave when you need structured relevance scores or synthesized answers. Best for news monitoring, finance research, and grounding LLM responses with cited web sources.

## Known failure modes

- Empty results if query is too niche or time range too narrow
- Synthesized answer may hallucinate if source content is ambiguous
- Domain filters that are too restrictive may return zero results
- Rate limiting or quota exhaustion returning an error
- Stale results if the web index hasn't crawled recent pages
- Invalid topic enum values causing a 400 error

## How this service works

Tavily — AI-native web search tuned for RAG: ranked results with relevance scores, optional LLM answer synthesis. Pass `query`; optional `topic` (general|news|finance), `max_results` (1-20), `include_answer` (true = synthesized answer), `include_raw_content` (true|"markdown" = full page text per hit), `include_domains`/`exclude_domains`, `time_range` (day|week|month|year), `country`. Alternative to exa/search (semantic recall) and brave/search (keyword index).

## Output

Returns a list of ranked web search results each containing a URL, title, snippet, and relevance score. Optionally includes a synthesized LLM-generated answer string and full raw page content (text or markdown) per result. Results can be filtered by domain, time range, and country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 2000,
       "minLength": 1
      },
      "topic": {
       "enum": [
        "general",
        "news",
        "finance"
       ],
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "time_range": {
       "enum": [
        "day",
        "week",
        "month",
        "year",
        "d",
        "w",
        "m",
        "y"
       ],
       "type": "string"
      },
      "max_results": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1
      },
      "include_answer": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "basic",
          "advanced"
         ],
         "type": "string"
        }
       ]
      },
      "exclude_domains": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "include_domains": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "include_raw_content": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "markdown",
          "text"
         ],
         "type": "string"
        }
       ]
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tavily-ai-native-web-search-via-vaaya-ai-4ae214db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)