Get Social Post Comments - Mosaic API Docs

Returns comments for a published social post with a fixed normalized shape. Responses are bounded so they are safe to consume from agents and automation jobs. Use the post_id returned by POST /social/post. Comments and nested replies are sorted by created_at descending. Comments without created_at are returned after comments with timestamps. Ties are ordered by platform, then comment_id, then platform_comment_id. Top-level comments are sorted before pagination.

Request

curl -X GET "https://api.mosaic.so/social/post/2d8ca860-f8e0-4f3f-9f2c-337ead6ed91e/comments" \
  -H "Authorization: Bearer mk_your_api_key"

Query Parameters

Field	Type	Required	Description
`social_connection_id`	string (uuid)	No	Get comments using one specific connected account. Useful when a post targets multiple accounts on the same platform.
`limit`	integer	No	Maximum comments to return. Defaults to `100`; maximum is `1000`.
`cursor`	string	No	Cursor returned by the previous response.

Platform Support

Comments are supported for x, linkedin, instagram, facebook, tiktok, and youtube.

Comment Object

Every item in comments and every item in comments[].replies has exactly these normalized fields:

Field	Type	Description
`comment_id`	string or null	Mosaic-normalized comment ID.
`platform_comment_id`	string or null	Native comment ID from the destination platform.
`platform`	string or null	One of `x`, `linkedin`, `instagram`, `facebook`, `tiktok`, `youtube`.
`social_connection_id`	string or null	Connected account used for the lookup.
`text`	string or null	Comment text.
`created_at`	string or null	Creation timestamp. `null` if the source response does not include it.
`comment_url`	string or null	Direct comment URL. `null` if the source response does not include it.
`like_count`	number or null	Like count. `null` if the source response does not include it.
`reply_count`	number or null	Reply count. `null` if the source response does not include it.
`parent_comment_id`	string or null	Parent comment ID for replies. `null` for top-level comments or when the source response does not include it.
`author`	object or null	Fixed author object. `null` if the source response does not include author metadata.
`media`	array	Media attachments on the comment. Always an array.
`replies`	array	Nested comments. Always an array.
`raw`	object or null	Unnormalized platform-specific comment payload.

When author is not null, it has exactly these fields: id, name, username, profile_url, and profile_image_url. Each value is a string or null. Every item in media has exactly these fields: type, url, thumbnail_url, mime_type, alt_text, and raw. type is one of image, video, gif, audio, document, or unknown.

Response

{
  "post_id": "2d8ca860-f8e0-4f3f-9f2c-337ead6ed91e",
  "platform": "linkedin",
  "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
  "comments": [
    {
      "comment_id": "comment_123",
      "platform_comment_id": "urn:li:comment:123",
      "platform": "linkedin",
      "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
      "text": "Looks great.",
      "created_at": "2026-03-10T17:12:00Z",
      "comment_url": "https://www.linkedin.com/feed/update/urn:li:activity:7351291821454032896?commentUrn=...",
      "like_count": 12,
      "reply_count": 2,
      "parent_comment_id": null,
      "author": {
        "id": null,
        "name": "Mosaic",
        "username": "mosaic-so",
        "profile_url": "https://www.linkedin.com/company/mosaic-so",
        "profile_image_url": null
      },
      "media": [
        {
          "type": "image",
          "url": "https://media.example.com/comment-image.jpg",
          "thumbnail_url": null,
          "mime_type": null,
          "alt_text": null,
          "raw": {
            "type": "image",
            "url": "https://media.example.com/comment-image.jpg"
          }
        }
      ],
      "replies": [
        {
          "comment_id": "comment_reply_456",
          "platform_comment_id": "urn:li:comment:456",
          "platform": "linkedin",
          "social_connection_id": "7f9388af-26e8-4e68-a52b-6b9a0ef3a017",
          "text": "Thanks!",
          "created_at": "2026-03-10T17:20:00Z",
          "comment_url": null,
          "like_count": null,
          "reply_count": null,
          "parent_comment_id": "comment_123",
          "author": null,
          "media": [],
          "replies": [],
          "raw": {
            "comment": "Thanks!",
            "created": "2026-03-10T17:20:00Z"
          }
        }
      ],
      "raw": {
        "comment": "Looks great.",
        "commentUrn": "urn:li:comment:123",
        "created": "2026-03-10T17:12:00Z",
        "likeCount": 12
      }
    }
  ],
  "pagination": {
    "limit": 100,
    "returned": 1,
    "total_available": 1,
    "has_more": false,
    "next_cursor": null,
    "sort": "created_at_desc"
  },
  "metadata": {
    "status": "success"
  }
}

Pagination

Comments are available after the post is published.
Normalized comment fields are fixed. Platform-specific fields are only returned inside raw.
Image, video, and other comment attachments are normalized into media; the original attachment payload remains in media[].raw.
Pagination cursors are based on the sorted response window.
This endpoint paginates the comments available in the current response window. It is not a guaranteed complete historical archive for posts with very high comment volume.
Some platforms return only a recent comments window, and comment data can update asynchronously.
This endpoint reads comments. It does not create, reply to, hide, or delete comments.

​Request

​Query Parameters

​Platform Support

​Comment Object

​Response