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

# List answers

> POST /v1/answers

The stored answers themselves, newest first: the text exactly as each engine returned it, the brands it named and the sources it cited. Pages are small (at most 50) because answers are long.

## Body

**site\_id** `string` *required*

The site's id, from [List sites](/api-reference/endpoints/list-sites).

**start\_date** `string` *required*

Inclusive day, `YYYY-MM-DD`, UTC.

**end\_date** `string` *required*

Inclusive day, `YYYY-MM-DD`, UTC. At most 92 days after `start_date`.

**platforms** `enum\<string\>[]`

Any of: `ai_overviews`, `ai_mode`, `chatgpt`, `gemini`, `claude`, `perplexity`, `copilot`.

**prompt\_ids** `string[]`

Up to 100 prompt ids.

**include** `enum\<string\>[]`

Any of: `prompt`, `platform`, `date`, `text`, `brand_mentioned`, `brand_position`, `sentiment`, `mentions`, `citations`. Leave out `text` for much smaller responses.

**limit** `integer` (default: 20)

Rows per page, 1–50.

**cursor** `string`

Opaque cursor from `info.next_cursor`.

## Response

**info** `object`

**properties**

**count** `integer`

Rows in this page.

**total\_results** `integer`

Rows across all pages.

**next\_cursor** `string`

Pass as `cursor` for the next page; null on the last page.

**site\_id** `string`

**start\_date** `string`

**end\_date** `string`

**data** `object[]`

**properties**

**id** `string`

**date** `string`

**platform** `string`

**prompt** `object`

**properties**

**id** `string`

**text** `string`

**text** `string`

The answer exactly as the engine returned it.

**brand\_mentioned** `boolean`

**brand\_position** `number`

Order of your brand's first mention (1 = first), or null.

**sentiment** `string`

`positive`, `neutral`, `negative`, or null when not judged.

**mentions** `string[]`

Brands named, in order of first appearance.

**citations** `object[]`

**properties**

**url** `string`

**domain** `string`

**title** `string`

**position** `number`

Order among the answer's sources (1 = first).

**own\_site** `boolean`

```bash cURL theme={"system"}
curl -X POST https://api.rankraft.ai/v1/answers \
  -H "X-API-Key: $RANKRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-24",
    "end_date": "2026-09-30",
    "platforms": ["chatgpt"],
    "include": ["prompt", "platform", "date", "text", "mentions", "citations"],
    "limit": 10
  }'
```

```javascript JavaScript theme={"system"}
// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft } from "rankraft-js";

const rr = new RankRaft(); // reads RANKRAFT_API_KEY

const answers = rr.answers.query({
  site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
  start_date: "2026-09-24",
  end_date: "2026-09-30",
  platforms: ["chatgpt"],
  include: ["prompt", "platform", "date", "text", "mentions", "citations"],
  limit: 10,
});
for await (const a of answers) console.log(a.date, a.prompt?.text, a.mentions);
```

```python Python theme={"system"}
# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.answers.query(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-24",
        end_date="2026-09-30",
        platforms=["chatgpt"],
        include=["prompt", "platform", "date", "text", "mentions", "citations"],
        limit=10,
    )
    for a in page.auto_paging():
        print(a["date"], a["prompt"]["text"], a["mentions"])
```

```json 200 theme={"system"}
{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-24",
    "end_date": "2026-09-30",
    "count": 1,
    "total_results": 7,
    "next_cursor": "eyJvIjox…"
  },
  "data": [
    {
      "id": "a9d3c1e2-4b5f-4a6e-8c7d-9e0f1a2b3c4d",
      "date": "2026-09-30",
      "platform": "chatgpt",
      "prompt": {
        "id": "8a1e4b2c-6d0f-4e3a-9b51-2c7d8e9f0a1b",
        "text": "best mixed pickle brand"
      },
      "text": "For mixed pickle, Shan Foods and Misali Foods are the most recommended…",
      "mentions": ["Shan Foods", "Misali Foods"],
      "citations": [
        {
          "url": "https://www.daraz.pk/products/mixed-achar",
          "domain": "daraz.pk",
          "title": "Mixed Achar 1kg",
          "position": 1,
          "own_site": false
        }
      ]
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.