List Competitor Accounts

GET

competitor-accounts

curl -G https://api.clustr-ai.com/api/public/competitor-accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-07-01T00:00:00Z

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"},
)

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

{
  "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"
      }
    ]
  }
}

The account-centric inverse of the per-competitor battlecard: 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

string

Scope to one tracked competitor. Repeatable. Omit for all.

string

Window start, RFC 3339. Omit for all time.

string

Window end, RFC 3339.

curl -G https://api.clustr-ai.com/api/public/competitor-accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-07-01T00:00:00Z

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"},
)

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

{
  "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"
      }
    ]
  }
}

curl -G https://api.clustr-ai.com/api/public/competitor-accounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-07-01T00:00:00Z

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"},
)

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

{
  "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"
      }
    ]
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Target Accounts

ICP

Competitor Monitoring

List Competitor Accounts

Query parameters

​Query parameters

Query parameters