Comments API Overview
Post, reply, get, and delete comments on a social post
The Comments endpoints allow your users to post, reply, retrieve, and delete comments on their posts. There are four types of comments IDs: ACME Post ID, Social Post ID, ACME Comment ID, and Social Comment ID. Each of these IDs are used for different purposes.
Comment ID Types
Comments with ACME Post ID
The typical flow is when you publish a post via ACME, you get the ACME Post ID. You can then use this ACME Post ID to manage comments on that post.
Supported platforms: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter, and YouTube.
For example:
Use the /post endpoint to publish a post via ACME, which can be sent to multiple social networks in a single call.
In the return is the top level ACME Post ID.
{
"status": "success",
"errors": [],
"postIds": [
{
"status": "success",
"id": "106638148652329_591370753547555",
"postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
"platform": "facebook"
}
],
"id": "E4UdUr1yRbvI7qqCSlaq", // ACME Post ID
"refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
"post": "What an amazing day",
"validate": true
}Use the /comments endpoint to post a comment with the ACME Post ID. The comment will be automatically posted to every social network where the original post was published. For example, if you published the post to Facebook and Instagram, the comment will appear on both platforms.
Use the /comments endpoint to get the comments for the post with the ACME Post ID. This will return all comments from every social network where the post was published. For example, if you posted to Facebook and Instagram, you'll get comments from both platforms.
Comments with Social Post ID
Sometimes you may want to manage comments on a post that were not published via ACME. In this case you can use the Social Post ID, which is the post ID assigned by the social network.
If the post was published via ACME, use the ACME Post ID.
For example:
Start by getting the Instagram posts published outside of ACME with the Get All Post History endpoint.
The endpoint returns a list of posts with the social id of the post.
{
"status": "success",
"posts": [
{
"mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
"permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
"commentsCount": 0,
"created": "2022-05-20T17:26:03Z",
"likeCount": 0,
"mediaProductType": "FEED",
"mediaType": "IMAGE",
"username": "thegoodone",
"id": "17833140557332933", // Instagram Social Post ID
"thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
"post": "The #Mandalorian is on tonight instead of Friday",
"postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
},
]
}Use the returned id to get all the comments for a specific Instagram post using the social id, searchPlatformId set to true, and platform set to instagram.
The returned JSON from the previous step will have a commentId for each comment, which is the social comment ID.
{
"instagram": [
{
"comment": "What an amazing comment",
"commentId": "17969247335804735", // Social Comment ID
"created": "2024-11-26T11:49:00Z",
"from": {
"id": "103038435208332",
"username": "john_smith"
},
"hidden": false,
"likeCount": 3,
"platform": "instagram",
"postId": "18231730279304333",
"username": "john_smith"
}
]
}
Comments with ACME Comment ID
Manage comments on a post that were published via ACME by using the ACME Comment ID.
The ACME comment ID is the comment ID assigned from ACME and can be found in the commentId field in the response when posting a comment.
This is often used if you want to get details on a particular comment published via ACME.
Comments with Social Comment ID
Manage comments on a post that were not published via ACME by using the Social Comment ID.
The social comment ID is the comment ID from the social network, not the ACME ID, and can be found in the commentId field in the response when getting comments.
This is often used if you want to get details on a particular comment published outside of ACME, such as LinkedIn replies to comments.
Disable Comments
You can disable comments when publishing a post using the disableComments field in the /post endpoint. Comments will only be disabled for Instagram, LinkedIn, and TikTok.
You may also enable or disable comments on an already published post using the update post endpoint and the disableComments field.