> ## 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 Competitor Accounts

> Every account your competitors are touching, ranked, with your CRM context

The account-centric inverse of [the per-competitor battlecard](/api-reference/get-competitor-detail): every account **any** tracked competitor is touching, ranked, folded across all of them.

Each row names which competitors are on the account and how many interactions each has, then layers your live CRM over it: owner, open deal (name, stage, amount, close date), and the `at_risk` flag — you own the account and have an open deal on it. `we_own: false` is white space (attack); `we_own: true` is a deal to defend.

Two scores, and they answer different questions. `signal_score` is all-time magnitude: how much attention has this account had. `courtship_score` is recency-first: is it being courted **right now**, with `courtship_velocity` (positive = accelerating) and a `courtship_label` of `hot`, `warming`, `active`, `cooling`, `dormant` or `none`.

## Query parameters

<ParamField query="competitor_id" type="string">
  Scope to one tracked competitor. Repeatable. Omit for all.
</ParamField>

<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/competitor-accounts \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d from=2026-07-01T00:00:00Z
  ```

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

  requests.get(
      "https://api.clustr-ai.com/api/public/competitor-accounts",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      params={"from": "2026-07-01T00:00:00Z"},
  )
  ```

  ```javascript JavaScript theme={null}
  await fetch(
    "https://api.clustr-ai.com/api/public/competitor-accounts?from=2026-07-01T00:00:00Z",
    { headers: { Authorization: "Bearer YOUR_API_KEY" } },
  );
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "summary": {
        "accounts_touched": 214,
        "at_risk": 9,
        "my_accounts": 63,
        "white_space": 151,
        "interactions": 4128,
        "competitors_active": 3
      },
      "accounts": [
        {
          "account_key": "northwind.com",
          "company_name": "Northwind Trading",
          "company_domain": "northwind.com",
          "company_numeric_id": "1553894",
          "we_own": true,
          "at_risk": true,
          "owner_name": "Alex Rivera",
          "owner_email": "alex@yourcompany.com",
          "has_open_deal": true,
          "deal_name": "Northwind — Platform expansion",
          "deal_stage": "Negotiation",
          "deal_amount": 84000,
          "deal_close_date": "2026-09-30",
          "signal_score": 91,
          "courtship_score": 78,
          "courtship_velocity": 0.42,
          "courtship_label": "hot",
          "last_touch_days": 2,
          "distinct_reps": 3,
          "interactions": 17,
          "comments": 4,
          "reactions": 13,
          "competitor_count": 2,
          "competitors": [
            { "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890", "name": "Globex Inc", "domain": "globex.com" },
            { "id": "d2b3c4d5-e6f7-8901-bcde-f23456789012", "name": "Initech", "domain": "initech.com" }
          ],
          "icp_targets": 5,
          "first_seen": "2026-05-02T08:11:00Z",
          "last_seen": "2026-07-28T14:02:11Z"
        }
      ]
    }
  }
  ```
</ResponseExample>