POST
/
comments
/
reply
/
:commentId
Available on Premium, Business, Enterprise plans.

Reply to a comment, i.e. comment on a comment, on either an Ayrshare made comment, using the Ayrshare Comment ID, or a comment made outside of Ayrshare, using the Social Comment ID.

Most often, you will reply to a comment made through Ayrshare, but when you want to reply to a comment made outside of Ayrshare, you can use the Social Comment ID, which you get GET /comment endpoint.

Header Parameters

Authorization
string
required
API Key of the Primary Profile.

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

Format: Profile-Key: PROFILE_KEY

Path Parameters

commentId
string
required

If replying to a comment made through Ayrshare, use the Ayrshare Comment ID commentId returned from the POST comment endpoint.

For example, the Ayrshare comment ID commentId returned from the POST comment endpoint is:

Ayrshare Comment ID Returned from POST /comment
{
  "commentId": "Ut1fWU6XkqkMayHGnJZ"
}

If replying to a comment made outside of Ayrshare, use the Social Comment ID commentId from the social network.

For example, the social comment ID commentId returned from a Facebook POST /comment or GET /comment endpoint is:

Social Comment ID Returned from POST /comment
{
  "facebook": { "commentId": "8392829334_1234567890" }
}

Body Parameters

platforms
array
required

If replying to a comment made through Ayrshare using the Ayrshare Comment ID, specify the platforms to post the reply. Supported platforms: bluesky, facebook, instagram, linkedin, tiktok, twitter, youtube.

If replying to a comment made outside of Ayrshare using the Social Comment ID, specify the one platform to post the reply. Supported platforms: facebook, instagram, linkedin, tiktok, twitter.

comment
string
required

The reply to add to the comment.

mediaUrls
array

Attach an image by providing the image URL. Only one image is supported. Facebook and LinkedIn only.

searchPlatformId
boolean
default:
false

Set to true if replying to a comment using the Social Comment ID, which is the post commentId from the social networks.

videoId
string

If replying to a TikTok comment with a Social Comment ID, you must also provide the TikTok video ID, which you get from the POST /comment endpoint or GET /comment endpoint. Only required for TikTok and "searchPlatformId": true.

objResponse
boolean
default:
true

Response as Object, otherwise as an Array. Default to true.