> ## 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. # List Social Selling posts > List the LinkedIn posts Social Selling tracks for your identities, newest first, with their latest LinkedIn metrics (impressions, reactions by type, comments, reposts) and Enginy engagement counters (engaged accounts, new engagers). Filter by identity and publish date. Reposts are hidden unless `includeReposts=true`. Responses include direct Enginy app URLs when available. Each post includes an `appUrl` that opens it in Enginy once it has a publishing post. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/posts openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/social-selling/posts: get: tags: - Social Selling summary: List Social Selling posts description: >- List the LinkedIn posts Social Selling tracks for your identities, newest first, with their latest LinkedIn metrics (impressions, reactions by type, comments, reposts) and Enginy engagement counters (engaged accounts, new engagers). Filter by identity and publish date. Reposts are hidden unless `includeReposts=true`. Responses include direct Enginy app URLs when available. Each post includes an `appUrl` that opens it in Enginy once it has a publishing post. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: integer minimum: 1 default: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 100 default: 20 required: false name: pageSize in: query - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 minItems: 1 description: >- Comma-separated identity ids. Defaults to every identity the caller may see. example: 12,34 required: false description: >- Comma-separated identity ids. Defaults to every identity the caller may see. name: identityIds in: query - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-09-01' description: Only posts published on or after this day (UTC). required: false description: Only posts published on or after this day (UTC). name: dateFrom in: query - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-09-01' description: Only posts published on or before this day (UTC). required: false description: Only posts published on or before this day (UTC). name: dateTo in: query - schema: type: boolean default: false description: Include reposts made by the identity. Off by default. required: false description: Include reposts made by the identity. Off by default. name: includeReposts in: query responses: '200': description: Paginated tracked posts content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: number description: >- Tracked post id. Use it for the other Social Selling endpoints. publishingPostId: type: - number - 'null' description: >- Publishing post id (schedules, reactions, comments). Null until first used. identity: type: object properties: id: type: number name: type: - string - 'null' required: - id - name linkedinPostUrn: type: string url: type: - string - 'null' postType: type: string example: ORIGINAL postedAt: type: - string - 'null' description: ISO timestamp. content: type: - string - 'null' metrics: type: object properties: impressions: type: - number - 'null' reactions: type: number reactionsByType: type: object additionalProperties: type: number comments: type: number reposts: type: number engagedAccounts: type: number description: >- Distinct external people who reacted or commented. newEngagers: type: number description: >- Engaged accounts seen for the first time on this post. refreshedAt: type: - string - 'null' description: When LinkedIn metrics were last fetched. required: - impressions - reactions - reactionsByType - comments - reposts - engagedAccounts - newEngagers - refreshedAt topics: type: array items: type: object properties: key: type: string label: type: string required: - key - label targetRoles: type: array items: type: object properties: key: type: string label: type: string required: - key - label appUrl: type: - string - 'null' description: >- Opens the post in Enginy (null until it has a publishing post). required: - id - publishingPostId - identity - linkedinPostUrn - url - postType - postedAt - content - metrics - topics - targetRoles - appUrl meta: type: object properties: page: type: number pageSize: type: number total: type: number required: - page - pageSize - total required: - data - meta '403': description: >- Social Selling is not enabled for this workspace. Ask your workspace admin to enable the feature. security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````