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

# List Competitors

> List monitored competitors and your slot usage

List the competitors monitored for your workspace, plus slot usage (`used` / `active` / `limit`). Requires the competitor-monitoring entitlement (`403` when the feature is off).

`active` counts only competitors with `status: active`; those are the ones that get run and the ones that consume a slot.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.clustr-ai.com/api/public/competitors \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  requests.get(
      "https://api.clustr-ai.com/api/public/competitors",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://api.clustr-ai.com/api/public/competitors", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "competitors": [
        {
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "company_name": "Globex Inc",
          "domain": "globex.com",
          "linkedin_url": "https://www.linkedin.com/company/globex",
          "status": "active",
          "created_at": "2026-06-30T09:00:00Z",
          "updated_at": "2026-06-30T09:00:00Z"
        },
        {
          "id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
          "company_name": "Initech",
          "domain": "initech.com",
          "linkedin_url": "https://www.linkedin.com/company/initech",
          "status": "paused",
          "created_at": "2026-06-20T11:30:00Z",
          "updated_at": "2026-06-28T08:15:00Z"
        }
      ],
      "slot_usage": { "used": 1, "active": 1, "limit": 5 }
    }
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": {
      "message": "Competitor monitoring is not enabled for this tenant",
      "code": "FORBIDDEN"
    }
  }
  ```
</ResponseExample>