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

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

Brands the site is compared against. `confirmed` competitors count in leaderboards and share of voice; unconfirmed ones were found in answers and are measured but not ranked until confirmed in the dashboard.

## Path parameters

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

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

## Response

**data** `object[]`

**properties**

**id** `string`

**name** `string`

**domains** `string[]`

**confirmed** `boolean`

**source** `string`

How the competitor was added. One of: `onboarding` (proposed during setup), `discovered` (found in answers), `manual` (added by your team).

```bash cURL theme={"system"}
curl https://api.rankraft.ai/v1/sites/3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f/competitors \
  -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

const competitors = await rr.sites.competitors({ site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f" });
for (const c of competitors) console.log(c.name, c.confirmed, c.domains);
```

```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
    for c in rr.sites.competitors(site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f"):
        print(c["name"], c["confirmed"], c["domains"])
```

```json 200 theme={"system"}
{
  "data": [
    {
      "id": "c1…",
      "name": "Shan Foods",
      "domains": [
        "shanfoods.com"
      ],
      "confirmed": true,
      "source": "discovered"
    }
  ]
}
```


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