Skip to main content
POST
/
comments
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.ayrshare.com/api/comments

{
  "status": "success",
  "commentID": "IUDSCfdYfFkw_dWhW9PLI", // Ayrshare Comment ID. Used for replying to a comment.
  "id": "Ut1fWU6XkqlMayHGnJZ", // Ayrshare 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/ayrshare.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/ayrshare/status/1525632403262101648"
  },
  "youtube": {
    "status": "success",
    "commentId": "UgzIEZsDQKXgHsEnwTR4AaABAa", // YouTube Social Comment ID
    "comment": "The best comment ever!",
    "platform": "youtube"
  },
}

Documentation Index

Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Add a comment to a post with an Ayrshare Post ID (posts sent via Ayrshare) or a Social Post ID (posts sent outside of Ayrshare) 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

​
Body Parameters

​
id
string
required
Ayrshare Post ID or Social Post ID from the /post endpoint.
​
comment
string
required
Text of the new comment to add to the post.
​
searchPlatformId
boolean
default:false
Set to true if posting a comment using the Social Post ID, which is the post id from the social networks.
​
platforms
array
required
Specify the platforms to add comments.If using an Ayrshare 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 Ayrshare Post ID
{
  "id": "Ut1fWU6XkqkMayHGnJZ", // Ayrshare 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
}
​
mediaUrls
array
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", // Ayrshare Post ID
  "comment": "An amazing comment!", // required
  "platforms": ["facebook"], // Facebook, LinkedIn, or X/Twitter only
  "mediaUrls": ["https://img.ayrshare.com/gb.jpg"]
}

​
@Mentions in Comments

You can include @mentions directly in the comment text string. There is no separate parameter for mentions. Simply add @handle in your comment text.
Comment with @Mention
{
  "id": "Ut1fWU6XkqkMayHGnJZ",
  "comment": "Great post @CompanyName! Love this.",
  "platforms": ["linkedin", "twitter", "facebook"]
}
LinkedIn Mentions: LinkedIn mentions are resolved server-side by Ayrshare. Use the LinkedIn Search endpoint to look up the correct vanity name or member name. For organizations, use @handle. For members, use @vanity_name or @[Full Name].
For detailed mention syntax and limitations per platform, see: See Post Verification for the platform-by-platform mention rules and recommendations. 
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.ayrshare.com/api/comments

{
  "status": "success",
  "commentID": "IUDSCfdYfFkw_dWhW9PLI", // Ayrshare Comment ID. Used for replying to a comment.
  "id": "Ut1fWU6XkqlMayHGnJZ", // Ayrshare 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/ayrshare.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/ayrshare/status/1525632403262101648"
  },
  "youtube": {
    "status": "success",
    "commentId": "UgzIEZsDQKXgHsEnwTR4AaABAa", // YouTube Social Comment ID
    "comment": "The best comment ever!",
    "platform": "youtube"
  },
}