> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research

> POST /v1/search/research — Multi-source research with AI synthesis.

<ParamField body="query" type="string" required>
  Research question
</ParamField>

<ParamField body="depth" type="string" default="quick">
  `"quick"` | `"thorough"` | `"exhaustive"`
</ParamField>

## Quick (inline response)

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl -X POST https://api.usenaive.ai/v1/search/research \
    -H "Authorization: Bearer nv_sk_live_..." \
    -H "Content-Type: application/json" \
    -d '{ "query": "Compare React Server Components vs Astro Islands", "depth": "quick" }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "synthesis": "Based on multiple sources...",
    "sources": [
      { "url": "...", "title": "...", "relevance": 0.9 }
    ],
    "credits_used": 0.5,
    "credits_remaining": 989.5
  }
  ```
</ResponseExample>

## Thorough / Exhaustive (async)

Returns a `202` with a job ID:

```json theme={"theme":"css-variables"}
{
  "job_id": "job-uuid",
  "status": "processing",
  "type": "deep_research",
  "estimated_seconds": 45,
  "estimated_credits": 1,
  "hint": "Poll GET /v1/jobs/job-uuid for results. Credits charged on completion only."
}
```

| Depth      | Credits | Time    |
| ---------- | ------- | ------- |
| quick      | 30      | Instant |
| thorough   | 50      | \~45s   |
| exhaustive | 80      | \~90s   |