Skip to main content
GET
The Signals feed. One row per interaction (comment, reaction, share) between a tracked competitor’s rep and a person at one of your accounts, across every competitor you monitor. Both directions are covered, and each row says which in direction:
  • outbound: the rep commented on or liked the person’s post.
  • inbound: the person commented on or liked the rep’s own post.
The person on the other side (target_*) is the one the row is about either way. In both directions, only people who match your buyer titles are kept, at your customers as at every other account. Each row carries who did it, who they engaged, that person’s company, the ICP verdict, your live CRM state for the account (in CRM, open deal, owner) and the comment classifier’s is_critical verdict with the reason it gave. This is the row data behind the Signals table in the app, with the same filters. Rows are ranked open-deal → in-CRM → critical → recency. Pass order=recent for a pure newest-first log, or order=seniority to rank a founder’s like above an SDR’s. Each row is shown under one competitor: competitor_id is the one your competitor_id filter picked, else the first, and competitor_ids lists every competitor the rep is tracked under. Repeat competitor_id to keep several competitors. Offset-paginated: pass the previous response’s next_offset as offset until has_more is false.

Authorizations

Authorization
string
header
required

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

Query Parameters

competitor_id
string[]

Repeatable for multi-select.

from
string<date-time>

The start of the time window, as an RFC 3339 timestamp, for example 2026-07-01T00:00:00Z.

to
string<date-time>
limit
integer

The most items to return. Missing or 0 takes the endpoint's default; above the endpoint's maximum, the maximum.

offset
integer

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

critical
enum<string>

critical_only keeps only the interactions flagged critical; all keeps every interaction.

Available options:
all,
critical_only
crm
enum<string>

Keeps interactions by the state of the engaged person's company in your CRM: all, in_crm, not_in_crm, open_deal or customer.

customer keeps only the accounts you already own, the companies on your customer list, so it returns nothing while your customer list is empty. Use it for a retention view, where a competitor working one of your customers calls for a different response than one working a prospect.

Available options:
all,
in_crm,
not_in_crm,
open_deal,
customer
type
enum<string>[]

Repeatable engagement-type filter.

Available options:
comment,
like,
share
target
string

Scope to one prospect's interactions (the prospect drawer).

role
enum<string>[]

Repeatable rep-role filter (the Role column's header filter).

Available options:
bdr,
ae,
am,
csm,
exec,
founder,
other
seniority
enum<string>

Repeatable rep-seniority filter (the Seniority column's header filter).

Available options:
high,
mid,
low,
unknown
order
enum<string>

recent drops the threat ranking and sorts newest-first (the Signals table, which is a log rather than a recommendation); seniority ranks a founder's like above an SDR's. Omit for threat order.

Available options:
recent,
seniority
direction
enum<string>

One side only. outbound: a competitor's monitored person commented on or liked someone's post. inbound: someone commented on or liked the person's own post. Omit for both. Each row carries direction.

Available options:
inbound,
outbound
account
string

One account's interactions: the LinkedIn numeric id of the engaged person's company (company_numeric_id on the competitor accounts). 400 when it is not numeric.

intent
enum<string>[]

Repeatable. any keeps the interactions on a post that shows buying intent; labels (hiring_for, evaluating, migrating, rfp, budget_or_project) keep those intents only. Omit for every interaction.

Available options:
any,
hiring_for,
evaluating,
migrating,
rfp,
budget_or_project
rep
string[]

Repeatable: the competitor's employees, by LinkedIn id (the filter-options rep values).

prospect
string[]

Repeatable: the prospects, by LinkedIn id.

company
string[]

Repeatable: the prospect's company, by target_company_id.

owner
string[]

Repeatable: the account owner's email in your CRM.

standing
enum<string>[]

Repeatable: where the account stands for you. customer = on your customer list, crm = in your CRM, new = neither.

Available options:
customer,
crm,
new
kind
enum<string>[]

Repeatable: likes, comments, or pitches (comments where their rep sells). Shares pass any pick.

Available options:
like,
comment,
pitch
q
string

Search over the employee, prospect, title, company, competitor and comment, case- and accent-insensitive.

Maximum string length: 200

Response

Typed result envelope.

success
boolean
required
data
object
required