API reference · Research
POST /v1/research
Run a multi-step research loop and return a cited synthesized answer.
Endpoint
POST
https://chat-api.you.com/researchRequest body
| Field | Type | Description |
|---|---|---|
| queryrequired | string | The research question. |
| depth | enum | shallow | standard | deep — controls how many subqueries the planner runs. default: standard |
| include_trace | boolean | Return the planner's intermediate reasoning steps. default: false |
Response
JSON
{
"answer": "string (markdown)",
"citations": [
{ "title": "string", "url": "string", "snippet": "string" }
],
"trace": [{ "step": "string", "...": "..." }]
}