List Competitor People

GET

competitor-people

curl "https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-people",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "paused", "function": "sales", "q": "helene"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "people": [
      {
        "clustr_competitor_tracked_person_id": "ctp_d73mfdcms7k6qtzyjqwrkdjh5e",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_pwf6z0866htjppk8va1djb15yz",
        "id": "9a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "person_linkedin_id": "helene-martin",
        "full_name": "Hélène Martin",
        "title": "Account Executive",
        "linkedin_url": "https://www.linkedin.com/in/helene-martin",
        "function": "sales",
        "status": "paused",
        "paused_reason": "no_slot",
        "source": "search",
        "monitored_since": null,
        "interactions_30d": 0
      }
    ],
    "total": 1,
    "slot_usage": { "used": 200, "total": 200, "paused": 12, "pending": 0, "plan": "l200", "active": 200, "limit": 200 }
  }
}

Every person tracked at any of your competitors, in one list, with the same columns as List Competitor Team plus competitor_name, and the slot counter. People you removed are left out unless status asks for them. The name search ignores case and accents: helene finds “Hélène”. The list comes ordered pending first (normally nobody), then Monitored, Paused and Left, then by rank and name.

curl "https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-people",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "paused", "function": "sales", "q": "helene"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "people": [
      {
        "clustr_competitor_tracked_person_id": "ctp_d73mfdcms7k6qtzyjqwrkdjh5e",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_pwf6z0866htjppk8va1djb15yz",
        "id": "9a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "person_linkedin_id": "helene-martin",
        "full_name": "Hélène Martin",
        "title": "Account Executive",
        "linkedin_url": "https://www.linkedin.com/in/helene-martin",
        "function": "sales",
        "status": "paused",
        "paused_reason": "no_slot",
        "source": "search",
        "monitored_since": null,
        "interactions_30d": 0
      }
    ],
    "total": 1,
    "slot_usage": { "used": 200, "total": 200, "paused": 12, "pending": 0, "plan": "l200", "active": 200, "limit": 200 }
  }
}

Authorizations

Authorization

string

header

required

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

Query Parameters

competitor_id

string

Keeps the people at these competitors, by their Clustr IDs (cmp_…). Repeat the parameter or send a comma-separated list. The ids from earlier responses also work.

function

string

Keeps the people in these functions, as a comma-separated list of sales, cs and other.

status

string

Keeps the people with these statuses, as a comma-separated list of monitored, paused, pending (shown as To validate in the app), left and removed. Defaults to every status except removed.

string

Searches people by name, ignoring case and accents.

limit

integer

default:50

The number of people per page, at most 200.

Required range: x <= 200

offset

integer

default:0

The number of people to skip, for paging.

Response

The people

success

boolean

required

Example:

true

data

object

required

Show child attributes

curl "https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-people",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"status": "paused", "function": "sales", "q": "helene"},
)

await fetch("https://api.clustr-ai.com/api/public/competitor-people?status=paused&function=sales&q=helene", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "people": [
      {
        "clustr_competitor_tracked_person_id": "ctp_d73mfdcms7k6qtzyjqwrkdjh5e",
        "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
        "clustr_person_id": "per_pwf6z0866htjppk8va1djb15yz",
        "id": "9a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
        "competitor_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "competitor_name": "Globex Inc",
        "person_linkedin_id": "helene-martin",
        "full_name": "Hélène Martin",
        "title": "Account Executive",
        "linkedin_url": "https://www.linkedin.com/in/helene-martin",
        "function": "sales",
        "status": "paused",
        "paused_reason": "no_slot",
        "source": "search",
        "monitored_since": null,
        "interactions_30d": 0
      }
    ],
    "total": 1,
    "slot_usage": { "used": 200, "total": 200, "paused": 12, "pending": 0, "plan": "l200", "active": 200, "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 People

Authorizations

Query Parameters

Response