Skip to main content
POST
List Social Engagement Engagers

Authorizations

X-API-Key
string
header
required

Body

application/json
linkedinUrl
string | null

Monitored LinkedIn profile or company page URL. Used alone, includes all matching subscriptions across the current team's signals. Combine with signalId to restrict to that signal. May be omitted when profileId or signalId is supplied.

limit
integer | null

Maximum rows to return. Defaults to 20, max 100.

cursor
string | null

Pagination cursor returned by a previous list_social_engagement_engagers response.

earliestEngagementPerContact
boolean | null

Defaults to true.

  • When true, keeps one earliest matching event by engaged_at per contact (normalized engager profile URL) after all filters, with the smallest event id breaking ties.
  • Without signalId, selects the earliest across all signals monitoring linkedinUrl; with signalId, selects the earliest within that signal; profileId narrows to one subscription.
  • When false, returns all matching events; URL-only calls collapse copies by normalized person URL plus saved event key across signals while preserving different actions.
  • Use false when further local filtering requires event history.
engagementType
enum<string> | null

Optional event kind: reaction or comment. reaction also matches legacy saved like events. Applied before deduplication and pagination.

Available options:
reaction,
comment,
post,
null
postUrl
string | null

Optional exact stored LinkedIn post URL, copied from post_url. No URL alias or tracking-parameter normalization is performed. Applied before deduplication and pagination.

engagedFromUtc
string<date-time> | null

Inclusive lower bound on engagement time (engaged_at), in ISO 8601 with an explicit UTC offset. Filters when the engagement happened, not when the post was published.

engagedToUtc
string<date-time> | null

Exclusive upper bound on engagement time (engaged_at), in ISO 8601 with an explicit UTC offset. Must be later than engagedFromUtc when both are supplied.

profileId
string | null

Exact monitored subscription ID from profiles[].id. Preferred selector when the same URL is monitored by multiple signals; linkedinUrl may be omitted.

signalId
string | null

Signal ID from list_social_engagement_signals. Used alone, includes all monitored profiles in that signal; no URL is required. Combine with linkedinUrl or profileId to narrow the selection.

Response

Tool result.