Skip to main content
GET
List Social Selling engagers

Authorizations

x-api-key
string
header
required

Query Parameters

dateFrom
string

First publication day (UTC) of the posts engaged with. Defaults to 89 days before dateTo.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-01"

dateTo
string

Last publication day (UTC, inclusive). Defaults to today. At most 366 days in total.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-01"

identityIds
integer[] | null

List of identity ids whose posts count (REST also accepts a comma-separated value). Defaults to every identity the caller may see; ids outside that scope are ignored.

Minimum array length: 1
Example:

"12,34"

contactStatus
enum<string>[] | null

List of contact statuses to keep (REST also accepts a comma-separated value): NEW (not in Enginy), IN_CRM (an Enginy contact not contacted yet), CONTACTED.

Minimum array length: 1
Available options:
NEW,
IN_CRM,
CONTACTED
Example:

"NEW,IN_CRM"

interaction
enum<string>
default:all

reacted / commented: only engagers with a reaction / comment on those posts.

Available options:
all,
reacted,
commented
company
string

Case-insensitive part of the engager’s current company name.

Required string length: 1 - 200
minEngagementScore
number | null

Keep engagers whose lifetime engagementScore is at least this. That score counts every identity of the workspace, including identities the caller cannot see.

Required range: x >= 0
sort
enum<string>
default:engagementScore

Highest first. engagementScore is the workspace-wide lifetime score; interactions/reactions/comments count the range’s posts of the caller’s identities only.

Available options:
engagementScore,
interactions,
reactions,
comments
page
integer
default:1
Required range: x >= 1
pageSize
integer
default:25
Required range: 1 <= x <= 100

Response

Paginated engagers

data
object[]
required
meta
object
required