Linkup deep research (start task)
linkup-researchRuns autonomous multi-source research for questions a single search cannot resolve, returning verified findings with citations and an audit trail.
Instructions
Start an autonomous research task with Linkup (POST /v1/research). Asynchronous: returns at once with id and status "pending"; the agent then plans, searches many sources in parallel, verifies and synthesises, in 2 to 20 minutes. Collect the result with linkup-wait-research (polls for you) or linkup-get-research.
Price per task by reasoning_depth: S 0.25 USD (2 to 5 min), M 0.50 (3 to 7 min),
L 1.50 (5 to 10 min, the default), XL 2.50 (10 to 20 min). Failed tasks are not billed.
Do not create a second task to "retry" a slow one; wait on the id you have.
Use it for questions a single search cannot resolve: verified answers with an audit trail
of citations, a focused investigation of one subject, or a broad report by theme. For a
quick fact use linkup-search. Set mode explicitly for predictable latency, cost and
shape. Phrase the question precisely: angles to cover, leads to pursue, facts to verify,
entities to compare, constraints, and the structure you expect back. Put dates in
from_date/to_date, give a few trusted include_domains when they exist.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "linkup-research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | answer: precise, evidence-backed answer with a definitive solution. investigate: focused report on one defined subject. research: structured report by theme over many topics or entities in parallel. Omit (API default auto) to let the agent classify the question. | |
| query | Yes | The research question, precise and complete (see tool description). | |
| to_date | No | YYYY-MM-DD, sources on or before this date. | |
| from_date | No | YYYY-MM-DD, sources on or after this date. | |
| output_type | No | sourcedAnswer: natural-language answer with citations and a sources list. structured: JSON matching structured_output_schema (keep it flat; nested arrays of objects raise latency and failure rate). | sourcedAnswer |
| exclude_domains | No | Domains to exclude. | |
| include_domains | No | Restrict sources to these domains (up to 100). Strongly recommended when authoritative sources are known: better quality, lower latency. | |
| reasoning_depth | No | S light, M balanced, L thorough (default), XL exhaustive. Higher depth does not mean a longer answer, it means more coverage. | L |
| structured_output_schema | No | Required when output_type is structured. JSON Schema (object or string), root type object. |