ACME API Documentation logo

Post a Comment

Add a comment to a published post

POSThttps://api.acme.com/api/comments
Available on Premium, Business, Enterprise plans.

Add a comment to a post with an ACME Post ID (posts sent via ACME) or a Social Post ID (posts sent outside of ACME) using the Comments API.

  • Comments added to an X Thread will be posted to the first Tweet.
  • Instagram Story comments are not yet supported by Meta.
  • See the platforms field below for supported platforms depending on the ID type.

Please see the Comments Overview for more information on the different ID types.

Supported platforms: Bluesky, Facebook, Instagram, LinkedIn, Reddit, TikTok, X, and YouTube.

Header Parameters

Authorizationstringrequired
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Keystring
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Body Parameters

idstringrequired

ACME Post ID or Social Post ID from the /post endpoint.

commentstringrequired

Text of the new comment to add to the post.

searchPlatformIdbooleandefault: false

Set to true if posting a comment using the Social Post ID, which is the post id from the social networks.

platformsarrayrequired

Specify the platforms to add comments.

If using an ACME Post ID the supported platforms are: bluesky, facebook, instagram, linkedin, reddit, tiktok, twitter, youtube.

If no platforms are specified, the comment will be published to all connected platforms that support comments.

Post a Comment with the ACME Post ID
{
  "id": "Ut1fWU6XkqkMayHGnJZ", // ACME Post ID
  "comment": "An amazing comment!", // required
  "platforms": [
    "bluesky",
    "facebook",
    "instagram",
    "linkedin",
    "reddit",
    "tiktok",
    "twitter",
    "youtube"
  ]
}

If using a Social Post ID the supported platforms are -only one platform allowed at a time : facebook, instagram, linkedin, tiktok, twitter.

Post a Comment with the Social Post ID
{
  "id": "1288899996423983105", // Social Post ID
  "comment": "An amazing comment!", // required
  "searchPlatformId": true, // required
  // facebook, instagram, linkedin, tiktok, twitter
  "platforms": ["facebook"] // Only specify one platform
}
mediaUrlsarray

Attach an image by providing the image URL for Facebook or X/Twitter.

Only one image is supported in the mediaUrls field. Supported platforms are Facebook, LinkedIn, and X/Twitter.
Post a Comment with an Image
{
  "id": "Ut1fWU6XkqkMayHGnJZ", // ACME Post ID
  "comment": "An amazing comment!", // required
  "platforms": ["facebook"], // Facebook, LinkedIn, or X/Twitter only
  "mediaUrls": ["https://img.acme.com/gb.jpg"]
}
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"id": "Ut1fWU6XkqkMayHGnJZ", "platforms": ["bluesky", "facebook", "instagram", "linkedin", "reddit", "tiktok", "twitter", "youtube"], "comment": "An amazing comment!"}' \
-X POST https://api.acme.com/api/comments
{
  "status": "success",
  "commentID": "IUDSCfdYfFkw_dWhW9PLI", // ACME Comment ID. Used for replying to a comment.
  "id": "Ut1fWU6XkqlMayHGnJZ", // ACME Post ID
  "bluesky": {
    "status": "success",
    "commentId": "at://did:plc:62musrcyanhro2lydyhlw7ci/app.bsky.feed.post/3lf4b4j3dqy2i",
    "cid": "bafyreiaoivcafelkpzhbbjco23pguyqmy7wucuvfxaifgj34qoyp7nrhhy",
    "comment": "Nice one this is",
    "platform": "bluesky",
    "postUrl": "https://bsky.app/profile/acme.com/post/3lf4b4j3dqy2i"
  },
  "facebook": {
    "status": "success",
    "commentId": "358482752285927_363474831785719", // Facebook Social Comment ID
    "comment": "The best comment ever!",
    "platform": "facebook"
  },
  "instagram": {
    "status": "success",
    "commentId": "17060111860440276", // Instagram Social Comment ID
    "comment": "The best comment ever!",
    "platform": "instagram"
  },
  "linkedin": {
    "status": "success",
    "commentId": "urn:li:comment:(urn:li:activity:7141202289402236928,7141205176207503360)", // LinkedIn Social Comment ID
    "comment": "Someone's sitting in the shade today because someone planted a tree a long time ago. - Warren Buffett",
    "commentUrn": "urn:li:comment:(urn:li:activity:7141202289402236928,7141205176207503360)", // Social comment Id from LinkedIn
    "platform": "linkedin"
  },
  "tiktok": {
    "status": "success",
    "commentId": "7260964914699764524", // TikTok Social Comment ID
    "comment": "The best comment ever!",
    "platform": "tiktok",
    "videoId": "7260964048362310959"
  },
  "twitter": {
    "status": "success",
    "commentId": "1525632403262101648", // Twitter Social Comment ID
    "comment": "The best comment ever!",
    "postUrl": "https://twitter.com/acme/status/1525632403262101648"
  },
  "youtube": {
    "status": "success",
    "commentId": "UgzIEZsDQKXgHsEnwTR4AaABAa", // YouTube Social Comment ID
    "comment": "The best comment ever!",
    "platform": "youtube"
  },
}