# Research Agent

> Research Agent API endpoint — 8 credits per call.

Source: http://localhost:3000/docs/endpoints/research

## Deep Research: `POST /v1/research/`

Plans sub-queries, reads sources and writes a cited report. Cost: 8 credits. Available on the free demo.

```bash
curl -X POST https://api.hushsearch.io/v1/research/ \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "How do vector databases handle filtering?",
  "depth": 2
}'
```

Multi-step research: generates sub-queries with Groq, searches all in parallel, scrapes top results, synthesizes a report.

```bash
curl -X POST https://api.hushsearch.io/v1/research/ \
  -H "X-API-Key: hs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"How does Apple Neural Engine work?","depth":3}'
```

| Parameter | Type | Default | Description |
|---|---|---|---|
| `query` | string | required | Research question |
| `depth` | integer | 3 | Sub-queries to generate |
| `num_results` | integer | 5 | Results per sub-query |
| `scrape_top` | integer | 3 | Pages to full-scrape for context |

**Note:** Set `GROQ_API_KEY` for AI-synthesized reports. Falls back to a structured text summary without it.
