Skip to main content
Social Selling tracks the LinkedIn posts published by your connected identities and the people who engage with them. The public API exposes the same numbers you see in Social Selling → Engagement, so an agent (or the MCP server) can answer “how did yesterday’s post do?” or arm reactions on a fresh post without opening the app.
Social Selling must be enabled for your workspace. Calls return 403 otherwise — ask your workspace admin. Read endpoints need the SOCIAL_SELLING_READ scope, the reactions endpoint needs SOCIAL_SELLING_WRITE.

​
Posts and metrics

GET /v1/social-selling/posts lists tracked posts newest first. Each item carries:
  • metrics.impressions, metrics.reactions (+ reactionsByType), metrics.comments, metrics.reposts — the latest LinkedIn numbers, refreshed daily and whenever someone opens the post in Enginy (metrics.refreshedAt).
  • metrics.engagedAccounts / metrics.newEngagers — distinct external people who reacted or commented, and how many were new to your workspace on this post. Teammates and blocklisted contacts are excluded.
  • topics / targetRoles — the AI classification configured under Configure topics and roles.
  • appUrl — opens the post in Enginy.
Filters: identityIds (comma-separated), dateFrom / dateTo (UTC days), includeReposts (off by default), plus page / pageSize.
GET /v1/social-selling/posts/{postId} returns one post; postId is the id from the list. Users restricted to specific identities only see posts of those identities, exactly like in the app.

​
Automatic reactions

POST /v1/social-selling/posts/{postId}/reactions schedules reactions from your connected LinkedIn identities:
  • amount — draw that many identities from the workspace pool that is allowed to react.
  • identityIds — or react from exactly these identities.
  • reactionTypes — optional mix (LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT).
  • skipAuthor — on by default: the post’s author never reacts to their own post.
Reactions are spread over time to look natural. The response includes the publishingPostId Enginy uses for scheduling and the appUrl where you can follow progress.
Scheduling new LinkedIn posts through the API is not available yet — use Social Selling → Publishing in the app for now.