> ## 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 post comments

> List the comment threads of a tracked Social Selling post: top-level comments oldest first with their replies nested (LinkedIn threads are one level deep), each with stable ids (`commentId`, LinkedIn `commentUrn`, `parentCommentId`), the author (profile link, whether they are one of your identities or the post author), text, LinkedIn creation time, reactions, deletion state and a `threadUrl` that opens it on LinkedIn. Comments come from Enginy’s last read of the post on LinkedIn (the daily sync, or `sync_social_selling_post_comments`), not a live read: check `coverage` for when that was and whether it was complete. `filter=unanswered` keeps the threads the `answeredBy` identity (default: the post author) has not replied to; `mentions` and `questions` keep threads naming the author or asking something; `since` (pass the previous `latestObservedAt`) keeps threads with something new. Comments by people on your blocklist are left out and counted in `hiddenByBlocklistCount`. Paginated by thread with `cursor`/`nextCursor`. Read-only.

    > **Required scope:** `SOCIAL_SELLING_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/posts/{postId}/comments
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/{postId}/comments:
    get:
      tags:
        - Social Selling
      summary: List Social Selling post comments
      description: >-
        List the comment threads of a tracked Social Selling post: top-level
        comments oldest first with their replies nested (LinkedIn threads are
        one level deep), each with stable ids (`commentId`, LinkedIn
        `commentUrn`, `parentCommentId`), the author (profile link, whether they
        are one of your identities or the post author), text, LinkedIn creation
        time, reactions, deletion state and a `threadUrl` that opens it on
        LinkedIn. Comments come from Enginy’s last read of the post on LinkedIn
        (the daily sync, or `sync_social_selling_post_comments`), not a live
        read: check `coverage` for when that was and whether it was complete.
        `filter=unanswered` keeps the threads the `answeredBy` identity
        (default: the post author) has not replied to; `mentions` and
        `questions` keep threads naming the author or asking something; `since`
        (pass the previous `latestObservedAt`) keeps threads with something new.
        Comments by people on your blocklist are left out and counted in
        `hiddenByBlocklistCount`. Paginated by thread with
        `cursor`/`nextCursor`. Read-only.

            > **Required scope:** `SOCIAL_SELLING_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            description: Tracked post id (`id` of the posts list).
          required: true
          description: Tracked post id (`id` of the posts list).
          name: postId
          in: path
        - schema:
            type: string
            enum:
              - all
              - unanswered
              - mentions
              - questions
            default: all
            description: >-
              `unanswered`: threads the `answeredBy` identity has not replied to
              (no non-deleted reply by it, not resolved or dismissed in the
              reply queue, not started by it). `mentions`: threads naming the
              post author. `questions`: threads with a question.
          required: false
          description: >-
            `unanswered`: threads the `answeredBy` identity has not replied to
            (no non-deleted reply by it, not resolved or dismissed in the reply
            queue, not started by it). `mentions`: threads naming the post
            author. `questions`: threads with a question.
          name: filter
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
            description: >-
              Identity whose replies count as answers for `unanswered` and
              `answered`. Defaults to the post author.
          required: false
          description: >-
            Identity whose replies count as answers for `unanswered` and
            `answered`. Defaults to the post author.
          name: answeredBy
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              Only threads with a comment or reply Enginy first read after this
              ISO instant. Pass the previous `latestObservedAt` to get only what
              is new.
            example: '2026-10-26T10:00:00Z'
          required: false
          description: >-
            Only threads with a comment or reply Enginy first read after this
            ISO instant. Pass the previous `latestObservedAt` to get only what
            is new.
          name: since
          in: query
        - schema:
            type: boolean
            default: false
            description: >-
              Include comments that disappeared from LinkedIn (marked
              `isDeleted`).
          required: false
          description: >-
            Include comments that disappeared from LinkedIn (marked
            `isDeleted`).
          name: includeDeleted
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: '`nextCursor` of the previous page.'
          required: false
          description: '`nextCursor` of the previous page.'
          name: cursor
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
            description: Threads per page (1–100).
          required: false
          description: Threads per page (1–100).
          name: limit
          in: query
      responses:
        '200':
          description: Comment threads of the post
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      post:
                        type: object
                        properties:
                          id:
                            type: number
                          publishingPostId:
                            type:
                              - number
                              - 'null'
                          identityId:
                            type: number
                          url:
                            type:
                              - string
                              - 'null'
                        required:
                          - id
                          - publishingPostId
                          - identityId
                          - url
                      answeredBy:
                        type: number
                      threads:
                        type: array
                        items:
                          type: object
                          properties:
                            commentId:
                              type: number
                              description: >-
                                Enginy id: what the reply, claim and resolve
                                tools take.
                            commentUrn:
                              type: string
                              description: LinkedIn comment urn.
                            parentCommentId:
                              type:
                                - number
                                - 'null'
                            parentCommentUrn:
                              type:
                                - string
                                - 'null'
                            author:
                              type: object
                              properties:
                                name:
                                  type:
                                    - string
                                    - 'null'
                                headline:
                                  type:
                                    - string
                                    - 'null'
                                profileUrl:
                                  type:
                                    - string
                                    - 'null'
                                identityId:
                                  type:
                                    - number
                                    - 'null'
                                  description: >-
                                    Set when the commenter is one of your
                                    identities.
                                isPostAuthor:
                                  type: boolean
                              required:
                                - name
                                - headline
                                - profileUrl
                                - identityId
                                - isPostAuthor
                            text:
                              type:
                                - string
                                - 'null'
                            createdAt:
                              type:
                                - string
                                - 'null'
                              description: When LinkedIn says it was written.
                            firstSeenAt:
                              type: string
                              description: When Enginy first read it.
                            editedObservedAt:
                              type:
                                - string
                                - 'null'
                              description: >-
                                When Enginy noticed an edit (LinkedIn exposes no
                                edit time).
                            reactionsCount:
                              type:
                                - number
                                - 'null'
                            isDeleted:
                              type: boolean
                            isQuestion:
                              type: boolean
                            mentionsPostAuthor:
                              type: boolean
                            threadUrl:
                              type:
                                - string
                                - 'null'
                              description: Opens the comment on LinkedIn.
                            answered:
                              type: boolean
                            queue:
                              type: object
                              properties:
                                state:
                                  type: string
                                  enum:
                                    - OPEN
                                    - CLAIMED
                                    - RESOLVED
                                    - DISMISSED
                                claimedByUserId:
                                  type:
                                    - number
                                    - 'null'
                                claimExpiresAt:
                                  type:
                                    - string
                                    - 'null'
                                resolution:
                                  type:
                                    - string
                                    - 'null'
                                resolvedAt:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - state
                                - claimedByUserId
                                - claimExpiresAt
                                - resolution
                                - resolvedAt
                            replies:
                              type: array
                              items:
                                type: object
                                properties:
                                  commentId:
                                    type: number
                                    description: >-
                                      Enginy id: what the reply, claim and
                                      resolve tools take.
                                  commentUrn:
                                    type: string
                                    description: LinkedIn comment urn.
                                  parentCommentId:
                                    type:
                                      - number
                                      - 'null'
                                  parentCommentUrn:
                                    type:
                                      - string
                                      - 'null'
                                  author:
                                    type: object
                                    properties:
                                      name:
                                        type:
                                          - string
                                          - 'null'
                                      headline:
                                        type:
                                          - string
                                          - 'null'
                                      profileUrl:
                                        type:
                                          - string
                                          - 'null'
                                      identityId:
                                        type:
                                          - number
                                          - 'null'
                                        description: >-
                                          Set when the commenter is one of your
                                          identities.
                                      isPostAuthor:
                                        type: boolean
                                    required:
                                      - name
                                      - headline
                                      - profileUrl
                                      - identityId
                                      - isPostAuthor
                                  text:
                                    type:
                                      - string
                                      - 'null'
                                  createdAt:
                                    type:
                                      - string
                                      - 'null'
                                    description: When LinkedIn says it was written.
                                  firstSeenAt:
                                    type: string
                                    description: When Enginy first read it.
                                  editedObservedAt:
                                    type:
                                      - string
                                      - 'null'
                                    description: >-
                                      When Enginy noticed an edit (LinkedIn
                                      exposes no edit time).
                                  reactionsCount:
                                    type:
                                      - number
                                      - 'null'
                                  isDeleted:
                                    type: boolean
                                  isQuestion:
                                    type: boolean
                                  mentionsPostAuthor:
                                    type: boolean
                                  threadUrl:
                                    type:
                                      - string
                                      - 'null'
                                    description: Opens the comment on LinkedIn.
                                required:
                                  - commentId
                                  - commentUrn
                                  - parentCommentId
                                  - parentCommentUrn
                                  - author
                                  - text
                                  - createdAt
                                  - firstSeenAt
                                  - editedObservedAt
                                  - reactionsCount
                                  - isDeleted
                                  - isQuestion
                                  - mentionsPostAuthor
                                  - threadUrl
                          required:
                            - commentId
                            - commentUrn
                            - parentCommentId
                            - parentCommentUrn
                            - author
                            - text
                            - createdAt
                            - firstSeenAt
                            - editedObservedAt
                            - reactionsCount
                            - isDeleted
                            - isQuestion
                            - mentionsPostAuthor
                            - threadUrl
                            - answered
                            - queue
                            - replies
                      total:
                        type: number
                      nextCursor:
                        type:
                          - string
                          - 'null'
                      coverage:
                        type: object
                        properties:
                          fetchedAt:
                            type:
                              - string
                              - 'null'
                            description: Last read of the threads from LinkedIn.
                          fetchedCount:
                            type:
                              - number
                              - 'null'
                          reportedCommentsCount:
                            type: number
                            description: LinkedIn’s own comment count (replies included).
                          storedCount:
                            type: number
                          complete:
                            type: boolean
                            description: >-
                              The last read returned every comment LinkedIn
                              reports.
                          stale:
                            type: boolean
                            description: Never read, or read more than 26 hours ago.
                        required:
                          - fetchedAt
                          - fetchedCount
                          - reportedCommentsCount
                          - storedCount
                          - complete
                          - stale
                      hiddenByBlocklistCount:
                        type: number
                      latestObservedAt:
                        type:
                          - string
                          - 'null'
                    required:
                      - post
                      - answeredBy
                      - threads
                      - total
                      - nextCursor
                      - coverage
                      - hiddenByBlocklistCount
                      - latestObservedAt
                required:
                  - status
                  - message
                  - data
        '400':
          description: Invalid query or cursor
        '403':
          description: >-
            Social Selling is not enabled for this workspace. Ask your workspace
            admin to enable the feature.
        '404':
          description: >-
            Post not found in this workspace or outside the caller’s identity
            scope, or `answeredBy` outside the caller’s scope
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.