List comments for a post or thread

POST 
/social-media-posting/comments/:platform/list

Paginated list of comments scoped to a post (parentId = postId) or a comment thread (parentId = commentId). Use skip/limit for pagination, sortBy for ordering, originIds to filter by connected account, and search for keyword search.

Request

Version stringrequired

API Version

Available optionsv3

platform stringrequired

Supported Comments Platforms

Available optionsfacebookinstagramlinkedincommunitytiktokblueskyyoutubethreads

locationId stringrequired

Location ID

application/json

application/json

Body

Bodyrequired

fromDatestring

Start of the published-date window (ISO 8601). If provided, toDate is also required, and fromDate must be ≤ toDate. Omit both to disable date filtering.

toDatestring

End of the published-date window (ISO 8601). If provided, fromDate is also required.

originIdsstring[]required

Origin IDs of connected accounts to filter by

sortBystring
Sort by top comments or latest comments
Available optionstoplatest
searchstring

Search

skipnumber
Pagination offset — number of comments to skip (zero-based). Must be ≥ 0.
Possible values: >= 0
Default value: 0
limitnumber
Pagination page size — number of comments to return. Must be between 1 and 100.
Possible values: >= 1 and <= 100
Default value: 10
parentIdstring

Parent ID — pass the Highlevel post ID (for replies under a specific post) or the Highlevel comment ID (for replies under a specific comment). Omit to list all top-level comments for the location filtered by originIds. Must be a valid 24-character Highlevel ID, not the native platform ID.

Example (auto)

{
  "fromDate": "2026-05-22T05:32:49.463Z",
  "toDate": "2026-05-29T05:32:49.463Z",
  "originIds": [
    "1234",
    "5678",
    "9101"
  ],
  "sortBy": "top",
  "search": "1234",
  "skip": 0,
  "limit": 10,
  "parentId": "6975b186f3442844ec07665b"
}

application/json

Successful response

application/json

Schema

Schema

successbooleanrequired

Success or Failure

statusCodenumberrequired

Status Code

messagestringrequired

Message

resultsobjectrequired

Comments and pagination metadata

Example (auto)

{
  "success": true,
  "statusCode": 201,
  "message": "Fetched Comments",
  "results": {
    "comments": [
      {
        "_id": "507f1f77bcf86cd799439011",
        "platform": "facebook",
        "platformCommentId": "122129390871181019_974705035458625",
        "platformParentId": "956033194258752_122129390871181019",
        "platformPostId": "122129390871181019",
        "postId": "6a169db95c78177a5c24ef7c",
        "originId": "956033194258752",
        "isParentThread": true,
        "isPost": false,
        "content": "Nice post!",
        "attachments": [
          {
            "type": "image/jpeg",
            "url": "https://example.com/image.jpg",
            "thumbnail": "https://example.com/thumb.jpg",
            "videoUrl": "https://example.com/video.mp4"
          }
        ],
        "author": {
          "id": "123456789",
          "name": "John Doe",
          "profilePic": "https://example.com/avatar.jpg"
        },
        "level": 1,
        "likeCount": 0,
        "reactionCount": 0,
        "replyCount": 0,
        "shareCount": 0,
        "repostCount": 0,
        "quoteCount": 0,
        "previewLink": "https://www.facebook.com/.../posts/...",
        "isRead": false,
        "isDeleted": false,
        "isEdited": false,
        "publishedAt": "2026-04-01T10:00:00.000Z",
        "createdAt": "2026-04-01T10:00:00.000Z",
        "updatedAt": "2026-04-01T10:00:00.000Z"
      }
    ],
    "meta": {
      "total": 42,
      "totalUnread": 7,
      "skip": 0,
      "limit": 10,
      "hasMore": true
    }
  }
}