> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Social Selling

> Read the LinkedIn posts Enginy tracks for your identities, their impressions and reactions, and schedule automatic reactions.

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.

<Note>
  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`.
</Note>

## 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`.

```bash theme={null}
curl "https://openapi.enginy.ai/v1/social-selling/posts?dateFrom=2026-09-01&pageSize=5" \
  -H "x-api-key: $ENGINY_API_KEY"
```

`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.

```bash theme={null}
curl -X POST "https://openapi.enginy.ai/v1/social-selling/posts/5051/reactions" \
  -H "x-api-key: $ENGINY_API_KEY" -H "content-type: application/json" \
  -d '{"amount": 25}'
```

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.

<Tip>
  Scheduling new LinkedIn posts through the API is not available yet — use **Social Selling → Publishing** in
  the app for now.
</Tip>