API Reference
Deepsearch
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.
POST
/
v1
/
deepsearch
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": 25,
"relevance_threshold": 0.5,
"included_sources": [
"valyu/valyu-arxiv",
"https://news.ycombinator.com/"
],
"category": "agentic use-cases",
"is_tool_call": false,
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"data_sources": [
"<string>"
],
"similarity_threshold": 123,
"query_rewrite": true
}'
{
"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
}
Authorizations
API key for authentication
Body
application/json
Search parameters for context retrieval
The body is of type object
.
Response
200
application/json
Successful response with search results
The response is of type object
.
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": 25,
"relevance_threshold": 0.5,
"included_sources": [
"valyu/valyu-arxiv",
"https://news.ycombinator.com/"
],
"category": "agentic use-cases",
"is_tool_call": false,
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"data_sources": [
"<string>"
],
"similarity_threshold": 123,
"query_rewrite": true
}'
{
"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
}
Assistant
Responses are generated using AI and may contain mistakes.