List Competitor Employees

GET

competitors

{id}

employees

curl "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/employees?page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

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

{
  "success": true,
  "data": {
    "employees": [
      {
        "clustr_person_id": "per_nqwttn6cdn76zkr53g90z624sh",
        "clustr_tracked_person_id": null,
        "person_linkedin_id": "ACwAAB1234567890abcdefghijklmnopqrstuv",
        "name": "Sam Lee",
        "title": "Partnerships Lead",
        "photo_url": "https://media.licdn.com/dms/image/sam.jpg",
        "linkedin_url": "https://www.linkedin.com/in/ACwAAB1234567890abcdefghijklmnopqrstuv",
        "function": "other",
        "tracked_status": null,
        "tracked_person_id": null
      }
    ],
    "page": 1,
    "has_more": true,
    "total": 412,
    "fetched_at": "2026-10-08T09:00:00Z"
  }
}

The competitor’s current employees beyond the Sales and CS people the team search found, so you can pick someone it missed. Clustr reads them from LinkedIn without a title filter, one page per call, and keeps each page for 30 days. Each row has person_linkedin_id: pass it as employee_id to Add Competitor Team Member to monitor that person. Someone already tracked carries tracked_status and tracked_person_id. q searches the names of the pages loaded so far, ignoring case and accents.

curl "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/employees?page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

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

{
  "success": true,
  "data": {
    "employees": [
      {
        "clustr_person_id": "per_nqwttn6cdn76zkr53g90z624sh",
        "clustr_tracked_person_id": null,
        "person_linkedin_id": "ACwAAB1234567890abcdefghijklmnopqrstuv",
        "name": "Sam Lee",
        "title": "Partnerships Lead",
        "photo_url": "https://media.licdn.com/dms/image/sam.jpg",
        "linkedin_url": "https://www.linkedin.com/in/ACwAAB1234567890abcdefghijklmnopqrstuv",
        "function": "other",
        "tracked_status": null,
        "tracked_person_id": null
      }
    ],
    "page": 1,
    "has_more": true,
    "total": 412,
    "fetched_at": "2026-10-08T09:00:00Z"
  }
}

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

page

integer

default:1

The page to read, from 1. has_more says whether there is a next one.

string

Searches the names on the pages loaded so far.

Response

One page of employees

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl "https://api.clustr-ai.com/api/public/competitors/cmp_r0jpyyqyeh0txpgdhb604j2g9s/employees?page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

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

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

{
  "success": true,
  "data": {
    "employees": [
      {
        "clustr_person_id": "per_nqwttn6cdn76zkr53g90z624sh",
        "clustr_tracked_person_id": null,
        "person_linkedin_id": "ACwAAB1234567890abcdefghijklmnopqrstuv",
        "name": "Sam Lee",
        "title": "Partnerships Lead",
        "photo_url": "https://media.licdn.com/dms/image/sam.jpg",
        "linkedin_url": "https://www.linkedin.com/in/ACwAAB1234567890abcdefghijklmnopqrstuv",
        "function": "other",
        "tracked_status": null,
        "tracked_person_id": null
      }
    ],
    "page": 1,
    "has_more": true,
    "total": 412,
    "fetched_at": "2026-10-08T09:00:00Z"
  }
}

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 Employees

Authorizations

Path Parameters

Query Parameters

Response