# Valyu - The Search API Built for AI Agents

> Your AI's gateway to real-time web search and specialised data sources. One API for web search and 36+ proprietary data sources.

## What is Valyu?

Valyu is the information layer for AI systems - providing unified access to web search AND specialised/proprietary data sources that aren't available through traditional search APIs. While competitors like Tavily and Exa only provide web search, Valyu gives AI agents access to authoritative knowledge from academic, financial, medical, and specialised databases.

## Core APIs

### Search API (`POST /v1/search`)
Search across web, academic papers, financial data, and proprietary datasets with semantic retrieval and intelligent ranking.

```python
from valyu import Valyu

valyu = Valyu(api_key="your-api-key")
response = valyu.search(
    query="latest FDA drug approvals for cancer treatment",
    search_type="all",  # or "proprietary", "web"
    max_num_results=10,
    included_sources=["valyu/valyu-pubmed", "valyu/valyu-fda-labels", "valyu/valyu-clinical-trials"]
)
```

### Contents API (`POST /v1/contents`)
Extract clean, structured content from web pages with AI-powered extraction and summarization.

```python
data = valyu.contents(
    urls=["https://example.com/article"],
    response_length="medium",
    extract_effort="auto"
)
```

### Answer API (`POST /v1/answer`)
Get AI-powered answers grounded by search with streaming support.

```python
data = valyu.answer(
    query="What are the latest developments in quantum computing?"
)
```

### DeepResearch API (`POST /v1/deepresearch/tasks`)
Comprehensive async research tasks with multi-step analysis across multiple sources.

```python
task = valyu.deepresearch.create(
    input="Analyze the competitive landscape of cloud computing in 2024",
    model="standard"  # fast ($0.10), standard ($0.50), heavy ($1.50)
)
result = valyu.deepresearch.wait(task.deepresearch_id)
```

### Datasources API (`GET /v1/datasources`)
Runtime discovery of available data sources with schemas and example queries.

## Data Sources (36+ Integrated)

### Research & Academic (40M+ papers)
- **arXiv**: 2.5M papers in physics, math, CS, quantitative biology
- **PubMed**: 37M biomedical literature citations
- **bioRxiv**: 250K biology preprints
- **medRxiv**: 80K medical preprints

### Healthcare & Life Sciences
- **Clinical Trials**: 500K trials from ClinicalTrials.gov
- **FDA Drug Labels**: 150K official drug information documents
- **ChEMBL**: 2.5M bioactive compounds
- **PubChem**: 100M chemical compounds
- **Open Targets**: 60K drug-disease associations

### Financial Markets (Real-time)
- **Stocks**: 200K+ instruments across 75 global exchanges
- **Crypto**: 200+ cryptocurrencies
- **Forex**: 180+ currency pairs
- **ETFs**: 25K exchange-traded funds
- **SEC Filings**: 3M+ filings (10-K, 10-Q, 8-K)
- **Earnings & Fundamentals**: Balance sheets, income statements, cash flow

### Economic Data
- **FRED**: 800K+ time series from Federal Reserve
- **BLS**: 10M labor statistics records
- **World Bank**: 200+ country indicators

### Other Sources
- **US Patents**: 8M+ patents from 2001+
- **Polymarket/Kalshi**: 200K+ prediction markets
- **Web Search**: Real-time web content

## Why Valyu vs Competitors?

| Feature | Valyu | Tavily | Exa | Perplexity |
|---------|-------|--------|-----|------------|
| Web Search | ✅ | ✅ | ✅ | ✅ |
| Academic Papers | ✅ | ❌ | ❌ | ❌ |
| SEC Filings | ✅ | ❌ | ❌ | ❌ |
| Clinical Trials | ✅ | ❌ | ❌ | ❌ |
| Patents | ✅ | ❌ | ❌ | ❌ |
| Drug Discovery Data | ✅ | ❌ | ❌ | ❌ |
| Economic Data | ✅ | ❌ | ❌ | ❌ |

## Benchmarks

- **FreshQA** (600 time-sensitive queries): 79% accuracy (vs Parallel 52%, Exa 24%)
- **SimpleQA** (4,326 factual questions): 94% accuracy
- **Finance**: 73% accuracy
- **MedAgent** (562 medical queries): 48% accuracy

## SDKs & Integrations

**SDKs:**
- Python: `pip install valyu`
- JavaScript/TypeScript: `npm install valyu-js`

**Integrations:**
- Vercel AI SDK, LangChain, LlamaIndex
- Claude Code Plugin, Claude Agent SDK
- AWS Bedrock AgentCore
- MCP Server and MCP Desktop
- OpenAI, Anthropic, Google

## Pricing

- **Search**: $0.50-50 per 1,000 retrievals (CPM) depending on source
- **Contents**: $0.001 per URL + AI processing
- **Answer**: Search costs + $12 per million tokens
- **DeepResearch**: $0.10 (Fast), $0.50 (Standard), $1.50 (Heavy)
- **Free Credits**: $10 to start, no credit card required

## Links

- Website: https://valyu.ai
- Platform: https://platform.valyu.ai
- Documentation: https://docs.valyu.ai
- Python SDK: https://pypi.org/project/valyu/
- JavaScript SDK: https://www.npmjs.com/package/valyu-js
- X (Twitter): https://x.com/ValyuOfficial
- LinkedIn: https://linkedin.com/company/valyu-ai
- GitHub: https://github.com/valyuAI
- Email: contact@valyu.ai