Search Medical Papers | Captain Docs

Search medical and biomedical papers with a natural-language question. Federates PubMed, PMC full-text, ClinicalTrials.gov, and Semantic Scholar, then synthesizes a cited answer.

Implementation: invokes the medical-agent Lambda (TypeScript, Mastra, Claude Sonnet). Streaming responses flow through the captain-stream S2 basin — identical pattern to /v2/collections/{name}/query.

Search medical and biomedical papers with a natural-language question. Federates PubMed, PMC full-text, ClinicalTrials.gov, and Semantic Scholar, then synthesizes a cited answer. Implementation: invokes the `medical-agent` Lambda (TypeScript, Mastra, Claude Sonnet). Streaming responses flow through the `captain-stream` S2 basin — identical pattern to `/v2/collections/{name}/query`.

Request

This endpoint expects an object.

questionstringRequired3-2000 characters

Natural-language question.

include_trialsbooleanOptionalDefaults to true

Whether the agent may call ClinicalTrials.gov.

max_sourcesintegerOptional1-25Defaults to 10

Target number of cited sources in the final answer.

recency_yearsintegerOptional1-50

Prefer evidence within the last N years where the question allows.

streambooleanOptionalDefaults to false

If true, response is text/event-stream; otherwise JSON.

Response

Synthesized answer with cited sources. Returns JSON by default; when stream=true the response is text/event-stream with tool.start, tool.end, text.delta, and run.end events.

answerstring

Synthesized answer with inline citations.

domainstring

The scientific domain, e.g. 'medical'.

gapslist of strings

Things the agent could not find or verify.

latency_msintegerDefaults to 0

End-to-end wall-clock latency.

sourceslist of objects

tool_callsintegerDefaults to 0

Number of tool calls the agent made.

Errors

400

Search Medical Papers Request Bad Request Error

401

Search Medical Papers Request Unauthorized Error

403

Search Medical Papers Request Forbidden Error

1	import requests
2
3	url = "https://host.com/v2/datasets/scientific/medical/ask"
4
5	payload = { "question": "question" }
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

1	{
2	"answer": "answer",
3	"domain": "domain",
4	"gaps": [
5	"gaps"
6	],
7	"latency_ms": 1,
8	"sources": [
9	{
10	"url": "url",
11	"title": "title",
12	"snippet": "snippet",
13	"dataset": "dataset",
14	"published_at": "published_at",
15	"authors": [
16	"authors"
17	],
18	"metadata": {
19	"key": "value"
20	}
21	}
22	],
23	"tool_calls": 1
24	}