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 options2021-07-28

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
    }
  }
}