Valyu API
Valyu API
Tool
valyu_create_task
Reference for creating a new deep research task via POST /v1/deepresearch/tasks.
Pricing
Per call
$0.02
Model
flat
Pay only for what you use. No subscriptions.
Inputs
mcp_servers
arraymetadata
objectwebhook_url
stringoutput_formats
stringquery *
stringcode_execution
booleandeliverables
arraymode
stringsearch
objecturls
arrayfiles
arrayprevious_reports
arraymodel
stringstrategy
stringTry It
API
MCP Config
Input Parameters
MCP server configurations for custom tools (max 5 servers)
Custom metadata for tracking
HTTPS URL for webhook notifications. When provided, Valyu will POST the full task result to this URL when the task completes or fails. The request includes X-Webhook-Signature and X-Webhook-Timestamp headers for verification. HTTP URLs are rejected—only HTTPS is supported.
Output formats. Use ['markdown'], ['markdown', 'pdf'], or a JSON schema object for structured output. Cannot mix JSON schema with markdown/pdf.
Research query or task description
Additional file outputs to generate from the research (CSV, Excel, PowerPoint, Word, PDF). Max 10 deliverables.
DeepResearch mode: fast: Ideal for quicker answers and lightweight research. Typically completes in ~2–5 minutes. standard: A balanced option for deeper insights without long wait times. Runs for ~10–20 minutes. heavy: Designed for in-depth, long-running research tasks. Can run for up to ~90 minutes.
Search configuration parameters
URLs to extract content from (max 10)
File attachments (PDFs, images, documents). Max 10 files.
Previous deep research IDs to use as context (max 3)
DeepResearch mode (deprecated, use 'mode' instead)
Natural language strategy instructions prepended to the system prompt