---
id: valyu
version: "2.12.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# valyu — Deepsearch API for AI.

License: permissive · Maintenance: active · Downloads: 106.3K/mo

## What it is and what it does

Valyu is a Python SDK that wraps a suite of research and search APIs designed to integrate external data into AI applications. It provides four main capabilities: web and proprietary data search with filtering and date range support, content extraction and summarization from URLs, AI-generated answers grounded in search results, and DeepResearch—a multi-step research agent that produces comprehensive reports with citations. The SDK also supports batch processing of research tasks, templated workflows with variable substitution, and programmatic access to available data sources. All request and response models use Pydantic v2 for type safety.

The package depends on requests, httpx, and pydantic for HTTP communication and data validation. It is designed for developers building AI agents, research automation tools, and applications that need to augment their own knowledge with current web data or proprietary sources. Authentication is API-key based, and the SDK includes error handling with transaction IDs for debugging.

Use it for:

- Build an AI agent that searches for recent scientific papers and extracts structured data from them for literature review automation.
- Create a research report generator that runs multi-step DeepResearch tasks to compile comprehensive competitor analysis or market trend reports.
- Integrate web search results into a chatbot or LLM application to ground AI-generated answers with current, cited sources.
- Automate batch processing of research queries across multiple topics, tracking progress and collecting results in parallel.
- Set up templated research workflows with variable placeholders to standardize recurring research tasks across your organization.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Valyu provides a Python SDK for accessing web search, content extraction, AI-grounded answers, and multi-step research APIs designed for AI agents and applications requiring external data integration.

Yes. Valyu is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. It is worth installing if you need to integrate external search, content extraction, or AI-powered research capabilities into an application. The main prerequisite is obtaining and configuring a Valyu API key; review pricing and quota terms on their platform before committing to production use.

## Install

pip install valyu
uv add valyu
poetry add valyu

## Installing valyu

Before you install: Low install friction with a pure Python wheel and three common runtime dependencies (requests, httpx, pydantic). Active maintenance with a recent release.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations.

Quickstart:

pip install valyu

from valyu import Valyu

valyu = Valyu()  # uses VALYU_API_KEY env var
response = valyu.search("latest advances in transformers", max_num_results=5)
for result in response.results:
    print(result.title, result.url)

Requires a Valyu API key set via VALYU_API_KEY environment variable or passed to Valyu(api_key=...).

Verify before relying:

- Whether the SDK supports async/await patterns beyond the documented async contents mode.
- Rate limits, quota behavior, and cost structure for different search types and data sources.
- Streaming support details and latency characteristics for real-time research workflows.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 106.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

search api sdk for ai agents, web content extraction python, grounded ai research api, multi-step research automation, proprietary data source search, url content extraction sdk, ai-powered search and research, ai-research-api, web-search-sdk, data-integration

[View on SkillFed](https://skillfed.io/packages/valyu) · [View on PyPI](https://pypi.org/project/valyu/)