# Build with Valyu

The search API for AI knowledge work - agent-native access to the sources knowledge work depends on.

Onboard your agents

Claude Code Open in Claude Code ↗ Codex Open in Codex ↗ Cursor Open in Cursor ↗

Search across the web and the sources knowledge work depends on.

```python Python theme={null} from valyu import Valyu client = Valyu(api_key="your-api-key") response = client.search( query="Latest AI inference datacenter projects", search_type="all", max_num_results=10 ) print(response) ``` ```javascript JavaScript theme={null} import { Valyu } from "valyu-js"; const client = new Valyu("your-api-key"); const response = await client.search("Latest AI inference datacenter projects", { searchType: "all", maxNumResults: 10 }); console.log(response); ``` ```bash cURL theme={null} curl --request POST \ --url https://api.valyu.ai/v1/search \ --header 'Content-Type: application/json' \ --header "x-api-key: $VALYU_API_KEY" \ --data '{ "query": "Latest AI inference datacenter projects", "search_type": "all", "max_num_results": 10 }' ``` [Learn more about the Search API →](/api-reference/endpoint/search)

Extract and summarise content from any URL.

```python Python theme={null} from valyu import Valyu client = Valyu(api_key="your-api-key") response = client.contents( ["https://www.morganstanley.com/insights/articles/economic-outlook-midyear-2025"], summary=True, extract_effort="high" ) print(response) ``` ```javascript JavaScript theme={null} import { Valyu } from "valyu-js"; const client = new Valyu("your-api-key"); const response = await client.contents([ "https://www.morganstanley.com/insights/articles/economic-outlook-midyear-2025" ], { summary: true, extractEffort: "high" }); console.log(response); ``` ```bash cURL theme={null} curl --request POST \ --url https://api.valyu.ai/v1/contents \ --header 'Content-Type: application/json' \ --header "x-api-key: $VALYU_API_KEY" \ --data '{ "urls": ["https://www.morganstanley.com/insights/articles/economic-outlook-midyear-2025"], "summary": true, "extract_effort": "high" }' ``` [Learn more about the Contents API →](/api-reference/endpoint/contents)

Get AI answers grounded by our search.

```python Python theme={null} from valyu import Valyu client = Valyu(api_key="your-api-key") response = client.answer( query="What did Apple cite as the main drivers of its revenue change in the MD&A section of its 2023 10-K?" ) print(response.contents) ``` ```javascript JavaScript theme={null} import { Valyu } from "valyu-js"; const client = new Valyu("your-api-key"); const response = await client.answer( "What did Apple cite as the main drivers of its revenue change in the MD&A section of its 2023 10-K?" ); console.log(response.contents); ``` ```bash cURL theme={null} curl --request POST \ --url https://api.valyu.ai/v1/answer \ --header 'Content-Type: application/json' \ --header "x-api-key: $VALYU_API_KEY" \ --data '{ "query": "What did Apple cite as the main drivers of its revenue change in the MD&A section of its 2023 10-K?" }' ``` [Learn more about the Answer API →](/api-reference/endpoint/answer)

Let AI search and research for you, delivering comprehensive reports.

```python Python theme={null} from valyu import Valyu client = Valyu(api_key="your-api-key") # Start a research task task = client.deepresearch.create( query="Analyze the impact of AI on healthcare" ) # Check status status = client.deepresearch.status(task.deepresearch_id) print(status) ``` ```javascript JavaScript theme={null} import { Valyu } from "valyu-js"; const client = new Valyu("your-api-key"); // Start a research task const task = await client.deepresearch.create({ query: "Analyze the impact of AI on healthcare" }); // Check status const status = await client.deepresearch.status(task.deepresearch_id); console.log(status); ``` ```bash cURL theme={null} curl --request POST \ --url https://api.valyu.ai/v1/deepresearch/tasks \ --header 'Content-Type: application/json' \ --header "x-api-key: $VALYU_API_KEY" \ --data '{ "query": "Analyze the impact of AI on healthcare" }' ``` [Learn more about DeepResearch →](/guides/deepresearch)

Start Building Hand one prompt to your coding agent and it sets Valyu up itself Make your first API call in minutes What Valyu is, the core APIs, and how they fit together Pay-per-use pricing, with plans that lower cost per credit