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

x-api-key
string
header
required

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.