List Engaged Prospects

GET

competitor-interactions

prospects

curl -G https://api.clustr-ai.com/api/public/competitor-interactions/prospects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d limit=25

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/prospects",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 25},
)

await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/prospects?limit=25",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "prospects": [
      {
        "clustr_target_person_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "clustr_competitor_ids": ["cmp_r0jpyyqyeh0txpgdhb604j2g9s"],
        "target_linkedin_id": "dana-p",
        "target_name": "Dana Patel",
        "target_job_title": "VP Revenue Operations",
        "company_name": "Northwind Trading",
        "company_domain": "northwind.com",
        "competitor_ids": ["c1a2b3c4-d5e6-7890-abcd-ef1234567890"],
        "interactions": 7,
        "comments": 2,
        "reactions": 5,
        "pleasantries": 1,
        "distinct_reps": 3,
        "icp_match": true,
        "icp_matched_keyword": "revenue operations",
        "has_critical": true,
        "critical_reason": "Rep offered a direct product comparison to a VP at an account with an open deal.",
        "in_crm": true,
        "is_customer": false,
        "has_open_deal": true,
        "latest_at": "2026-07-28T14:02:11Z",
        "latest_type": "comment"
      }
    ],
    "has_more": false,
    "next_offset": 0
  }
}

The same data as the Signals feed, folded to one row per person rather than one row per interaction. This is the denoised default view: a rep who liked six of someone’s posts is one row here and six there. Each row gives the distinct competitors on that person, the rep and interaction counts (split into comments and reactions), the ICP verdict, your CRM state, whether any of their interactions was flagged critical, and the latest touch. To see the individual interactions behind a row, call the flat feed with ?target=<target_linkedin_id>. Takes the flat feed’s window, competitor, CRM, critical, type and direction filters. It does not take target, order, role or seniority. pleasantries counts the comments that are pleasantries, such as “Congrats!”. They say no more than a like.

curl -G https://api.clustr-ai.com/api/public/competitor-interactions/prospects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d limit=25

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/prospects",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 25},
)

await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/prospects?limit=25",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "prospects": [
      {
        "clustr_target_person_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "clustr_competitor_ids": ["cmp_r0jpyyqyeh0txpgdhb604j2g9s"],
        "target_linkedin_id": "dana-p",
        "target_name": "Dana Patel",
        "target_job_title": "VP Revenue Operations",
        "company_name": "Northwind Trading",
        "company_domain": "northwind.com",
        "competitor_ids": ["c1a2b3c4-d5e6-7890-abcd-ef1234567890"],
        "interactions": 7,
        "comments": 2,
        "reactions": 5,
        "pleasantries": 1,
        "distinct_reps": 3,
        "icp_match": true,
        "icp_matched_keyword": "revenue operations",
        "has_critical": true,
        "critical_reason": "Rep offered a direct product comparison to a VP at an account with an open deal.",
        "in_crm": true,
        "is_customer": false,
        "has_open_deal": true,
        "latest_at": "2026-07-28T14:02:11Z",
        "latest_type": "comment"
      }
    ],
    "has_more": false,
    "next_offset": 0
  }
}

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 engaged by this tracked competitor, by its Clustr ID (cmp_…). Repeat the parameter for several competitors. The id from earlier responses also works.

from

string<date-time>

The start of the time window, as an RFC 3339 timestamp.

string<date-time>

The end of the time window, as an RFC 3339 timestamp.

crm

enum<string>

Keeps people by the state of their company in your CRM: all, in_crm, not_in_crm, open_deal or customer. customer keeps only the companies on your client list.

Available options:

all,

in_crm,

not_in_crm,

open_deal,

customer

critical

enum<string>

critical_only keeps only the people with an interaction flagged critical.

Available options:

all,

critical_only

type

enum<string>

Keeps the interactions of this kind: comment, like or share. Repeat the parameter for several kinds.

Available options:

comment,

like,

share

direction

enum<string>

Keeps one direction: outbound (the salesperson engaged the person's post) or inbound (the person engaged the salesperson's own post). Leave it out for both.

Available options:

outbound,

inbound

role

enum<string>

Keeps the interactions by a competitor salesperson in this role: bdr, ae, am, csm, exec, founder or other. Repeat the parameter for several roles.

Available options:

bdr,

ae,

am,

csm,

exec,

founder,

other

limit

integer

The number of people per page.

offset

integer

The number of people to skip, for the next page.

Response

A page of engaged prospects

success

boolean

required

Example:

true

data

object

required

curl -G https://api.clustr-ai.com/api/public/competitor-interactions/prospects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d limit=25

import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-interactions/prospects",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 25},
)

await fetch(
  "https://api.clustr-ai.com/api/public/competitor-interactions/prospects?limit=25",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } },
);

{
  "success": true,
  "data": {
    "prospects": [
      {
        "clustr_target_person_id": "per_pfc2a7z0j6r9sbtedxy7gayf39",
        "clustr_competitor_ids": ["cmp_r0jpyyqyeh0txpgdhb604j2g9s"],
        "target_linkedin_id": "dana-p",
        "target_name": "Dana Patel",
        "target_job_title": "VP Revenue Operations",
        "company_name": "Northwind Trading",
        "company_domain": "northwind.com",
        "competitor_ids": ["c1a2b3c4-d5e6-7890-abcd-ef1234567890"],
        "interactions": 7,
        "comments": 2,
        "reactions": 5,
        "pleasantries": 1,
        "distinct_reps": 3,
        "icp_match": true,
        "icp_matched_keyword": "revenue operations",
        "has_critical": true,
        "critical_reason": "Rep offered a direct product comparison to a VP at an account with an open deal.",
        "in_crm": true,
        "is_customer": false,
        "has_open_deal": true,
        "latest_at": "2026-07-28T14:02:11Z",
        "latest_type": "comment"
      }
    ],
    "has_more": false,
    "next_offset": 0
  }
}

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 Engaged Prospects

Authorizations

Query Parameters

Response