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

# Get Competitor Detail

> The battlecard for one competitor — ranked accounts, reps, and activity over time

The battlecard for one competitor, computed live from everything collected so far:

* **`accounts`** — every account they are touching, ranked, with the attack/defend split and at-risk flag from your CRM. `we_own: false` is white space to attack; `we_own: true` with an open deal is `at_risk`.
* **`reps`** — their go-to-market people folded across all activity, with role bucket, interaction counts and first/last active.
* **`activity`** — interactions bucketed over time, for the trend.
* **`summary`** — the same header tallies [the summaries endpoint](/api-reference/list-competitor-summaries) returns for every competitor at once.

## Path parameters

<ParamField path="id" type="string" required>
  Competitor ID, from [List Competitors](/api-reference/list-competitors).
</ParamField>

## Query parameters

<ParamField query="from" type="string">
  Window start, RFC 3339. Omit for all time.
</ParamField>

<ParamField query="to" type="string">
  Window end, RFC 3339.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890/detail \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d from=2026-05-01T00:00:00Z
  ```

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

  requests.get(
      "https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890/detail",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      params={"from": "2026-05-01T00:00:00Z"},
  )
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "summary": {
        "persons_tracked": 24,
        "interactions": 2871,
        "accounts_touched": 148,
        "atk_accounts": 101,
        "def_accounts": 47,
        "at_risk": 6
      },
      "accounts": [
        {
          "account_key": "northwind.com",
          "company_name": "Northwind Trading",
          "company_domain": "northwind.com",
          "company_numeric_id": "1553894",
          "we_own": true,
          "at_risk": true,
          "owner_email": "alex@yourcompany.com",
          "has_open_deal": true,
          "deal_name": "Northwind — Platform expansion",
          "deal_stage": "Negotiation",
          "deal_amount": 84000,
          "signal_score": 91,
          "courtship_score": 78,
          "courtship_label": "hot",
          "last_touch_days": 2,
          "distinct_reps": 3,
          "interactions": 17
        }
      ],
      "reps": [
        {
          "rep_linkedin_id": "samir-k",
          "rep_name": "Samir Khoury",
          "rep_title": "Enterprise AE",
          "role_bucket": "ae",
          "interactions": 412,
          "comments": 88,
          "reactions": 324,
          "distinct_accounts": 61,
          "first_active": "2026-03-14T09:40:00Z",
          "last_active": "2026-07-28T14:02:11Z"
        }
      ],
      "activity": [
        { "bucket": "2026-07-20", "interactions": 34 },
        { "bucket": "2026-07-27", "interactions": 41 }
      ]
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "Competitor not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>