Competitor Monitoring
Get Competitor Detail
The battlecard for one competitor — ranked accounts, reps, and activity over time
GET
/
competitors
/
{id}
/
detail
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
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"},
)
await fetch(
"https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890/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": [
{
"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 }
]
}
}
{
"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: falseis white space to attack;we_own: truewith an open deal isat_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.
Path parameters
string
required
Competitor ID, from List Competitors.
Query parameters
string
Window start, RFC 3339. Omit for all time.
string
Window end, RFC 3339.
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
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"},
)
await fetch(
"https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890/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": [
{
"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 }
]
}
}
{
"success": false,
"error": { "message": "Competitor not found", "code": "NOT_FOUND" }
}
⌘I
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
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"},
)
await fetch(
"https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890/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": [
{
"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 }
]
}
}
{
"success": false,
"error": { "message": "Competitor not found", "code": "NOT_FOUND" }
}