List Competitor Team

GET

competitors

{id}

tracked-persons

curl https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

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

{
  "success": true,
  "data": {
    "tracked_persons": [
      {
        "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
        "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "person_linkedin_id": "jane-doe",
        "full_name": "Jane Doe",
        "title": "VP Sales",
        "headline": "VP Sales at Globex",
        "avatar_url": "https://media.licdn.com/dms/image/jane.jpg",
        "role_bucket": "exec",
        "priority": 1,
        "source": "search",
        "status": "monitored",
        "function": "sales",
        "monitored_since": "2026-09-02T09:00:00Z",
        "paused_reason": null,
        "function_changed_at": null,
        "interactions_30d": 14,
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "still_employed": true,
        "last_activity_at": "2026-10-01T14:20:00Z",
        "created_at": "2026-09-02T09:00:00Z",
        "updated_at": "2026-10-01T14:20:00Z"
      }
    ],
    "slot_usage": { "used": 182, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 182, "limit": 200 }
  }
}

A competitor’s Team: everyone Clustr tracks there, with the slot counter. The team search finds the Sales and CS people when the competitor is added, and the monthly team refresh follows the new joiners automatically while you have free slots; past your limit they are added Paused. You can add someone it missed and remove someone who should not be there. Each row carries:

Field	Column	Values
`full_name`, `avatar_url`, `linkedin_url`	Person
`title`	Role	Their current title.
`function`	Function	`sales`, `cs` or `other`, from your title list.
`status`	Status	`monitored` (takes a slot, activity collected), `paused` (Paused, no slot; `paused_reason` is `no_slot` or `manual`), `pending` (waiting for a decision; normally nobody, since joiners are followed automatically), `left` (Left the company, with `left_at` and `new_company_name`), `removed` (hidden by default).
`source`	Source	`search` (Auto extraction), `manual` or `employee_list` (Manual addition), `refresh` (Detected at refresh).
`monitored_since`	Added on	When they last became monitored.
`interactions_30d`	Interactions (30 d)	Retained interactions over the last 30 days.

function_changed_at and function_changed_title flag someone whose title moved outside Sales and CS: keep them with Update Competitor Team Member (status: "monitored"), or remove them. The list comes ordered pending first (normally nobody), then Monitored, Paused and Left, each ranked founders and executives first, then account managers and CSMs, AEs, BDRs and everyone else (priority 1 to 5).

curl https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

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

{
  "success": true,
  "data": {
    "tracked_persons": [
      {
        "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
        "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "person_linkedin_id": "jane-doe",
        "full_name": "Jane Doe",
        "title": "VP Sales",
        "headline": "VP Sales at Globex",
        "avatar_url": "https://media.licdn.com/dms/image/jane.jpg",
        "role_bucket": "exec",
        "priority": 1,
        "source": "search",
        "status": "monitored",
        "function": "sales",
        "monitored_since": "2026-09-02T09:00:00Z",
        "paused_reason": null,
        "function_changed_at": null,
        "interactions_30d": 14,
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "still_employed": true,
        "last_activity_at": "2026-10-01T14:20:00Z",
        "created_at": "2026-09-02T09:00:00Z",
        "updated_at": "2026-10-01T14:20:00Z"
      }
    ],
    "slot_usage": { "used": 182, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 182, "limit": 200 }
  }
}

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

include_excluded

enum<string>

1 also lists the people removed from the Team. They carry excluded_at and status: "removed".

Available options:

0,

1

status

string

Comma-separated statuses to keep: monitored, paused, pending, left, removed. By default, every status except removed.

Response

The Team

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/tracked-persons",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

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

{
  "success": true,
  "data": {
    "tracked_persons": [
      {
        "clustr_competitor_tracked_person_id": "ctp_q3zg328tqgcw33xj4v2ahrcfeq",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_jzypgvc4wm1qqmh076ewd8ys7h",
        "id": "5d2f8a1c-7b3e-4c9a-8f1d-2e6b0a4c9d71",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "person_linkedin_id": "jane-doe",
        "full_name": "Jane Doe",
        "title": "VP Sales",
        "headline": "VP Sales at Globex",
        "avatar_url": "https://media.licdn.com/dms/image/jane.jpg",
        "role_bucket": "exec",
        "priority": 1,
        "source": "search",
        "status": "monitored",
        "function": "sales",
        "monitored_since": "2026-09-02T09:00:00Z",
        "paused_reason": null,
        "function_changed_at": null,
        "interactions_30d": 14,
        "linkedin_url": "https://www.linkedin.com/in/jane-doe",
        "still_employed": true,
        "last_activity_at": "2026-10-01T14:20:00Z",
        "created_at": "2026-09-02T09:00:00Z",
        "updated_at": "2026-10-01T14:20:00Z"
      }
    ],
    "slot_usage": { "used": 182, "total": 200, "paused": 12, "pending": 3, "plan": "l200", "active": 182, "limit": 200 }
  }
}

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

List Competitor Team

Authorizations

Path Parameters

Query Parameters

Response