# Cited Answer

> A direct answer to a question with numbered citations to its sources.

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

## Cited Answer: `POST /v1/answer/`

A grounded answer with numbered citations and a groundedness score. Cost: 4 credits. Available on the free demo.

```bash
curl -X POST https://api.hushsearch.io/v1/answer/ \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "What is reciprocal rank fusion?",
  "num_results": 5
}'
```

Ask a question and get a short, grounded answer. Each claim is marked `[n]`, pointing at `sources[n-1]`.

## Parameters

| Field | Type | Default | Notes |
|---|---|---|---|
| `query` | string | — | **Required.** The question. |
| `num_results` | integer | `5` | Sources to read. `max_results` is accepted as an alias. |
| `include_raw_content` | boolean | `false` | Include the scraped source text. |

## Response

```json
{
  "answer": "Reciprocal rank fusion merges ranked lists by summing 1/(k + rank) for each document [1][2].",
  "sources": [
    { "index": 1, "title": "Reciprocal Rank Fusion …", "url": "https://…" }
  ],
  "citation_count": 2,
  "credits_used": 4,
  "credits_remaining": 496,
  "response_time_ms": 3120
}
```

For multi-step investigation with a full report, use [Deep Research](http://localhost:3000/docs/endpoints/research).
