Get Competitor Detail

GET

competitors

{id}

detail

curl -G https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-05-01T00:00:00Z

import requests

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

await fetch(
  "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "summary": {
      "persons_tracked": 24,
      "interactions": 2871,
      "accounts_touched": 148,
      "atk_accounts": 101,
      "def_accounts": 47,
      "at_risk": 6
    },
    "accounts": [
      {
        "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
        "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": [
      {
        "clustr_rep_person_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "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 }
    ]
  }
}

{
  "success": false,
  "error": { "message": "Competitor not found", "code": "NOT_FOUND" }
}

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 returns for every competitor at once.

curl -G https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-05-01T00:00:00Z

import requests

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

await fetch(
  "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "summary": {
      "persons_tracked": 24,
      "interactions": 2871,
      "accounts_touched": 148,
      "atk_accounts": 101,
      "def_accounts": 47,
      "at_risk": 6
    },
    "accounts": [
      {
        "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
        "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": [
      {
        "clustr_rep_person_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "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 }
    ]
  }
}

{
  "success": false,
  "error": { "message": "Competitor not found", "code": "NOT_FOUND" }
}

Authorizations

Authorization

string

header

required

The API key you created on the API settings page of the Clustr app.

Path Parameters

string

required

The competitor's Clustr ID (cmp_…), from List Competitors. The id from earlier responses also works.

Query Parameters

from

string<date-time>

The start of the time window, as an RFC 3339 timestamp. Leave it out to cover all time.

string<date-time>

The end of the time window, as an RFC 3339 timestamp.

Response

Ranked accounts, reps and activity buckets

success

boolean

required

Example:

true

data

object

required

curl -G https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d from=2026-05-01T00:00:00Z

import requests

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

await fetch(
  "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/detail",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "summary": {
      "persons_tracked": 24,
      "interactions": 2871,
      "accounts_touched": 148,
      "atk_accounts": 101,
      "def_accounts": 47,
      "at_risk": 6
    },
    "accounts": [
      {
        "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
        "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": [
      {
        "clustr_rep_person_id": "per_bs9t25pnx8ax5p80ckexz9r35s",
        "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 }
    ]
  }
}

{
  "success": false,
  "error": { "message": "Competitor not found", "code": "NOT_FOUND" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Notes

Record Activity

Tags

Target Accounts

Client Companies

Excluded Companies

Buyer Titles

ICP

Competitor Monitoring

Connector Refresh

Notifications

Get Competitor Detail

Authorizations

Path Parameters

Query Parameters

Response