> ## 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 prompts

> GET /v1/sites/{site_id}/prompts

The questions RankRaft asks the engines for this site, oldest first.

## Path parameters

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

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

## Query parameters

**status** `enum\<string\>`

One of: `active`, `disabled`.

**category** `enum\<string\>`

One of: `Discovery`, `Comparison`, `Alternatives`, `How-to`, `Pricing`, `Brand`.

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

Page size, 1 to 500.

**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.

**data** `object[]`

**properties**

**id** `string`

**text** `string`

**category** `enum\<string\>`

One of: `Discovery`, `Comparison`, `Alternatives`, `How-to`, `Pricing`, `Brand`.

**market** `string`

Location appended to the question when it is asked, e.g. `Pakistan`. Null uses the site's market.

**status** `enum\<string\>`

One of: `active`, `disabled`.

**created\_at** `string`

**updated\_at** `string`

```bash cURL theme={"system"}
curl https://api.rankraft.ai/v1/sites/3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f/prompts \
  -H "X-API-Key: $RANKRAFT_API_KEY"
```

```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

// every prompt, across pages
for await (const p of rr.prompts.list({ site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f", status: "active" })) {
  console.log(p.id, p.category, p.text);
}
```

```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.prompts.list(site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f", status="active")
    for p in page.auto_paging():  # every prompt, across pages
        print(p["id"], p["category"], p["text"])
```

```json 200 theme={"system"}
{
  "info": {
    "count": 1,
    "total_results": 1,
    "next_cursor": null
  },
  "data": [
    {
      "id": "8a1e4b2c-6d0f-4e3a-9b51-2c7d8e9f0a1b",
      "text": "best mixed pickle brand",
      "category": "Discovery",
      "market": null,
      "status": "active",
      "created_at": "2026-09-02T08:12:00.000Z",
      "updated_at": "2026-09-02T08:12:00.000Z"
    }
  ]
}
```


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