Competitor Monitoring
List Competitors
List monitored competitors and your person slot usage
GET
/
competitors
curl https://api.clustr-ai.com/api/public/competitors \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
requests.get(
"https://api.clustr-ai.com/api/public/competitors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
await fetch("https://api.clustr-ai.com/api/public/competitors", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
{
"success": true,
"data": {
"competitors": [
{
"clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
"clustr_account_id": "acc_0v7tgcp9dspw8x9zc6teb5qx8z",
"id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
"company_name": "Globex Inc",
"domain": "globex.com",
"linkedin_url": "https://www.linkedin.com/company/globex",
"linkedin_numeric_id": "1035",
"linkedin_vanity_name": "globex",
"created_at": "2026-06-30T09:00:00Z",
"updated_at": "2026-06-30T09:00:00Z"
},
{
"clustr_competitor_id": "cmp_5ry79b7b4dh6544gqk56z0dx8c",
"id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
"company_name": "Initech",
"domain": "initech.com",
"linkedin_url": "https://www.linkedin.com/company/initech",
"created_at": "2026-06-20T11:30:00Z",
"updated_at": "2026-06-28T08:15:00Z"
}
],
"slot_usage": { "used": 64, "total": 200, "paused": 0, "pending": 2, "plan": "l200", "active": 64, "limit": 200 }
}
}
{
"success": false,
"error": {
"message": "Competitor Monitoring is not in this workspace's plan.",
"code": "FEATURE_NOT_ENABLED"
}
}
List the competitors monitored for your workspace, plus your slot usage. Requires the competitor-monitoring entitlement (
403 when the feature is off).
Slots count people, not competitors: each monitored person takes one slot, whatever the competitor. slot_usage has used (monitored people), total (your limit), paused, pending (normally 0: joiners are followed automatically) and plan, the same counter as Get Competitor Slots. active and limit carry the same values as used and total.
curl https://api.clustr-ai.com/api/public/competitors \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
requests.get(
"https://api.clustr-ai.com/api/public/competitors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
await fetch("https://api.clustr-ai.com/api/public/competitors", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
{
"success": true,
"data": {
"competitors": [
{
"clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
"clustr_account_id": "acc_0v7tgcp9dspw8x9zc6teb5qx8z",
"id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
"company_name": "Globex Inc",
"domain": "globex.com",
"linkedin_url": "https://www.linkedin.com/company/globex",
"linkedin_numeric_id": "1035",
"linkedin_vanity_name": "globex",
"created_at": "2026-06-30T09:00:00Z",
"updated_at": "2026-06-30T09:00:00Z"
},
{
"clustr_competitor_id": "cmp_5ry79b7b4dh6544gqk56z0dx8c",
"id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
"company_name": "Initech",
"domain": "initech.com",
"linkedin_url": "https://www.linkedin.com/company/initech",
"created_at": "2026-06-20T11:30:00Z",
"updated_at": "2026-06-28T08:15:00Z"
}
],
"slot_usage": { "used": 64, "total": 200, "paused": 0, "pending": 2, "plan": "l200", "active": 64, "limit": 200 }
}
}
{
"success": false,
"error": {
"message": "Competitor Monitoring is not in this workspace's plan.",
"code": "FEATURE_NOT_ENABLED"
}
}
⌘I
curl https://api.clustr-ai.com/api/public/competitors \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
requests.get(
"https://api.clustr-ai.com/api/public/competitors",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
await fetch("https://api.clustr-ai.com/api/public/competitors", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
{
"success": true,
"data": {
"competitors": [
{
"clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
"clustr_account_id": "acc_0v7tgcp9dspw8x9zc6teb5qx8z",
"id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
"company_name": "Globex Inc",
"domain": "globex.com",
"linkedin_url": "https://www.linkedin.com/company/globex",
"linkedin_numeric_id": "1035",
"linkedin_vanity_name": "globex",
"created_at": "2026-06-30T09:00:00Z",
"updated_at": "2026-06-30T09:00:00Z"
},
{
"clustr_competitor_id": "cmp_5ry79b7b4dh6544gqk56z0dx8c",
"id": "d2b3c4d5-e6f7-8901-bcde-f23456789012",
"company_name": "Initech",
"domain": "initech.com",
"linkedin_url": "https://www.linkedin.com/company/initech",
"created_at": "2026-06-20T11:30:00Z",
"updated_at": "2026-06-28T08:15:00Z"
}
],
"slot_usage": { "used": 64, "total": 200, "paused": 0, "pending": 2, "plan": "l200", "active": 64, "limit": 200 }
}
}
{
"success": false,
"error": {
"message": "Competitor Monitoring is not in this workspace's plan.",
"code": "FEATURE_NOT_ENABLED"
}
}