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.
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.
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.
Get Social Post Comments
Get comments for a social post.
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_idreturned byPOST /social/post.Comments and nested replies are sorted by
created_atdescending. Comments withoutcreated_atare returned after comments with timestamps. Ties are ordered byplatform, thencomment_id, thenplatform_comment_id. Top-level comments are sorted before pagination.Request
Query Parameters
social_connection_idlimit100; maximum is1000.cursorPlatform Support
Comments are supported for
x,linkedin,instagram,facebook,tiktok, andyoutube.Comment Object
Every item in
commentsand every item incomments[].replieshas exactly these normalized fields:comment_idplatform_comment_idplatformx,linkedin,instagram,facebook,tiktok,youtube.social_connection_idtextcreated_atnullif the source response does not include it.comment_urlnullif the source response does not include it.like_countnullif the source response does not include it.reply_countnullif the source response does not include it.parent_comment_idnullfor top-level comments or when the source response does not include it.authornullif the source response does not include author metadata.mediarepliesrawWhen
authoris notnull, it has exactly these fields:id,name,username,profile_url, andprofile_image_url. Each value is a string ornull.Every item in
mediahas exactly these fields:type,url,thumbnail_url,mime_type,alt_text, andraw.typeis one ofimage,video,gif,audio,document, orunknown.Response
Pagination
raw.media; the original attachment payload remains inmedia[].raw.