curl --request POST \
--url https://api.valyu.network/v1/deepsearch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"query": "implementation of agentic search-enhanced large reasoning models",
"max_num_results": 10,
"search_type": "all",
"max_price": 30,
"relevance_threshold": 0.5,
"included_sources": [
"https://docs.aws.amazon.com/",
"techcrunch.com/news",
"valyu/valyu-arxiv"
],
"excluded_sources": [
"https://news.ycombinator.com/",
"github.com/valyu",
"valyu/valyu-pubmed"
],
"category": "agentic use-cases",
"response_length": "short",
"country_code": "US",
"is_tool_call": false,
"start_date": "2024-01-01",
"end_date": "2024-12-31"
}'
{
"success": true,
"error": "",
"tx_id": "tx_12345678-1234-1234-1234-123456789abc",
"query": "implementation of agentic search-enhanced large reasoning models",
"results": [
{
"id": "unique_result_id",
"title": "Breakthrough in Quantum Computing Architecture",
"url": "https://example.com/article?utm_source=valyu.network&utm_medium=referral&utm_campaign=ai_pilot&utm_content=ai_query",
"content": "Detailed article content about quantum computing developments...",
"source": "web",
"length": 1250,
"image_url": "https://example.com/image.jpg",
"publication_date": "2024-03-15",
"doi": "10.1000/example",
"citation": "Author et al. (2024)",
"citation_count": 42,
"authors": [
"Dr. Jane Smith",
"Dr. John Doe"
],
"references": "Reference information",
"price": 0.015,
"data_type": "unstructured",
"source_type": "website"
}
],
"results_by_source": {
"web": 5,
"proprietary": 3
},
"total_deduction_pcm": 150,
"total_deduction_dollars": 0.15,
"total_characters": 12500
}
The deepsearch endpoint searches over the web, Valyu’s full-text multimodal indicies, financial data and more, returning only the most relevant content for your AI. Whether you just need simple web search, or deepsearch over academic journals, we’ve got you covered.
curl --request POST \
--url https://api.valyu.network/v1/deepsearch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"query": "implementation of agentic search-enhanced large reasoning models",
"max_num_results": 10,
"search_type": "all",
"max_price": 30,
"relevance_threshold": 0.5,
"included_sources": [
"https://docs.aws.amazon.com/",
"techcrunch.com/news",
"valyu/valyu-arxiv"
],
"excluded_sources": [
"https://news.ycombinator.com/",
"github.com/valyu",
"valyu/valyu-pubmed"
],
"category": "agentic use-cases",
"response_length": "short",
"country_code": "US",
"is_tool_call": false,
"start_date": "2024-01-01",
"end_date": "2024-12-31"
}'
{
"success": true,
"error": "",
"tx_id": "tx_12345678-1234-1234-1234-123456789abc",
"query": "implementation of agentic search-enhanced large reasoning models",
"results": [
{
"id": "unique_result_id",
"title": "Breakthrough in Quantum Computing Architecture",
"url": "https://example.com/article?utm_source=valyu.network&utm_medium=referral&utm_campaign=ai_pilot&utm_content=ai_query",
"content": "Detailed article content about quantum computing developments...",
"source": "web",
"length": 1250,
"image_url": "https://example.com/image.jpg",
"publication_date": "2024-03-15",
"doi": "10.1000/example",
"citation": "Author et al. (2024)",
"citation_count": 42,
"authors": [
"Dr. Jane Smith",
"Dr. John Doe"
],
"references": "Reference information",
"price": 0.015,
"data_type": "unstructured",
"source_type": "website"
}
],
"results_by_source": {
"web": 5,
"proprietary": 3
},
"total_deduction_pcm": 150,
"total_deduction_dollars": 0.15,
"total_characters": 12500
}
API key for authentication
Search parameters for context retrieval
The body is of type object
.
Successful response with search results
The response is of type object
.