Get Competitor Account

GET

competitor-accounts

{accountID}

curl https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
    "account_id": "1553894",
    "company_name": "Northwind Trading",
    "company_domain": "northwind.com",
    "is_customer": true,
    "use_case": "defense",
    "interactions_30d": 6,
    "interactions_90d": 14,
    "last_interaction_at": "2026-10-02T09:41:00Z",
    "by_competitor": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex/",
        "interactions_30d": 6,
        "interactions_90d": 14,
        "reps": [
          {
            "clustr_person_id": "per_x3mj8hbn822n1xybc73f80s3em",
            "linkedin_id": "sam-globex",
            "name": "Sam Carter",
            "title": "Account Executive at Globex",
            "linkedin_url": "https://www.linkedin.com/in/sam-globex/",
            "count": 9,
            "last_interaction_at": "2026-10-02T09:41:00Z"
          }
        ],
        "last_interaction_at": "2026-10-02T09:41:00Z",
        "weekly": [
          { "week": "2026-07-13", "interactions": 0 },
          { "week": "2026-07-20", "interactions": 1 },
          { "week": "2026-10-05", "interactions": 2 }
        ]
      }
    ]
  }
}

Which competitors are working one account, and how. For each competitor:

interactions_30d and interactions_90d: interactions in every direction (their salespeople liking or commenting on people at the account, and people at the account liking or commenting on their salespeople’s posts);
reps: the salespeople involved, with how many interactions each had in 90 days;
last_interaction_at;
weekly: 13 weeks of counts, oldest first and this week last, so you can see whether it recurs.

use_case is defense when the account is your customer (on your client list, or a customer in your CRM) and attack otherwise. At your customers everyone counts, whatever their title; at every other account only people who match your buyer titles count. Ignored interactions do not. For the interactions themselves, see account interactions.

curl https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
    "account_id": "1553894",
    "company_name": "Northwind Trading",
    "company_domain": "northwind.com",
    "is_customer": true,
    "use_case": "defense",
    "interactions_30d": 6,
    "interactions_90d": 14,
    "last_interaction_at": "2026-10-02T09:41:00Z",
    "by_competitor": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex/",
        "interactions_30d": 6,
        "interactions_90d": 14,
        "reps": [
          {
            "clustr_person_id": "per_x3mj8hbn822n1xybc73f80s3em",
            "linkedin_id": "sam-globex",
            "name": "Sam Carter",
            "title": "Account Executive at Globex",
            "linkedin_url": "https://www.linkedin.com/in/sam-globex/",
            "count": 9,
            "last_interaction_at": "2026-10-02T09:41:00Z"
          }
        ],
        "last_interaction_at": "2026-10-02T09:41:00Z",
        "weekly": [
          { "week": "2026-07-13", "interactions": 0 },
          { "week": "2026-07-20", "interactions": 1 },
          { "week": "2026-10-05", "interactions": 2 }
        ]
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

accountID

string

required

The account's Clustr ID (acc_…). Its LinkedIn numeric company id, the company_numeric_id that List Competitor Accounts returns, also works.

Response

The account's competitors

success

boolean

required

Example:

true

data

object

required

curl https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-accounts/acc_2mhxbznjtvpympw45ng1m3333c", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "clustr_account_id": "acc_2mhxbznjtvpympw45ng1m3333c",
    "account_id": "1553894",
    "company_name": "Northwind Trading",
    "company_domain": "northwind.com",
    "is_customer": true,
    "use_case": "defense",
    "interactions_30d": 6,
    "interactions_90d": 14,
    "last_interaction_at": "2026-10-02T09:41:00Z",
    "by_competitor": [
      {
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "name": "Globex Inc",
        "domain": "globex.com",
        "linkedin_url": "https://www.linkedin.com/company/globex/",
        "interactions_30d": 6,
        "interactions_90d": 14,
        "reps": [
          {
            "clustr_person_id": "per_x3mj8hbn822n1xybc73f80s3em",
            "linkedin_id": "sam-globex",
            "name": "Sam Carter",
            "title": "Account Executive at Globex",
            "linkedin_url": "https://www.linkedin.com/in/sam-globex/",
            "count": 9,
            "last_interaction_at": "2026-10-02T09:41:00Z"
          }
        ],
        "last_interaction_at": "2026-10-02T09:41:00Z",
        "weekly": [
          { "week": "2026-07-13", "interactions": 0 },
          { "week": "2026-07-20", "interactions": 1 },
          { "week": "2026-10-05", "interactions": 2 }
        ]
      }
    ]
  }
}

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 Account

Authorizations

Path Parameters

Response