# TavilyX Paid Search + RAG API

> TavilyX Paid Search + RAG API is a paid API for AI agents from searchtav.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Performs paid web search and synthesizes results using RAG (Retrieval-Augmented Generation) via Tavily and NVIDIA NIM, billed per-call via x402 on Base.

## Facts

- Endpoint: GET https://searchtav.vercel.app/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tavilyx-paid-search-rag-api-840e9459
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2hf9J7BdM_fTHf6G1Ct51

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 tavilyx-paid-search-rag-api-840e9459
```

Example prompt: Search the web for the latest developments in quantum computing hardware in 2024 and give me the top 5 most relevant results with their summaries.

## When to prefer this

Choose this endpoint when you need real-time, up-to-date web search results with AI-synthesized, relevance-scored content rather than static knowledge. It is particularly useful for agents that need current information (news, recent research, live data) and want both raw URLs and pre-processed content snippets in a single call. Prefer it over generic search APIs when RAG-quality synthesis and NVIDIA NIM-backed ranking are desired, and when the x402 micropayment model on Base fits your billing setup.

## Known failure modes

- Missing required 'q' parameter returns a 400 Bad Request
- Payment not received or insufficient USDC triggers a 402 Payment Required response
- Query yields no matching web results, returning an empty results array
- Limit parameter out of range (outside 1-10) may cause a validation error
- Tavily or NVIDIA NIM upstream outage causes a 502 or 503 error
- Invalid topic value may result in unfiltered or degraded results

## How this service works

Paid web search + RAG synthesis API. Tavily + NVIDIA NIM + x402 on Base.

## Output

Returns a JSON object containing the original query, an array of up to 10 ranked results (each with URL, title, content snippet, and relevance score), and the response time in seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query"
  },
  "limit": {
   "type": "integer",
   "description": "Max results (1-10)"
  },
  "topic": {
   "enum": [
    "general",
    "news"
   ],
   "type": "string",
   "description": "Search topic"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "score": {
      "type": "number"
     },
     "title": {
      "type": "string"
     },
     "content": {
      "type": "string"
     }
    }
   }
  },
  "response_time": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tavilyx-paid-search-rag-api-840e9459/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from searchtav.vercel.app](https://www.zero.xyz/host/searchtav.vercel.app/llms.txt)