Post a Comment

Add a comment to a published post

POST /comments

cURL

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

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/comments", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    id: "Ut1fWU6XkqkMayHGnJZ", // required
    platforms: ["bluesky", "facebook", "instagram", "linkedin", "reddit", "tiktok", "twitter", "youtube"], // required
    comment: "An amazing comment!", //required
  }),
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'id': 'Ut1fWU6XkqkMayHGnJZ',
        'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin', 'reddit', 'tiktok', 'twitter', 'youtube'],
        'comment': 'An amazing comment!'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/comments',
    json=payload,
    headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/comments';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$data = json_encode([
    'id' => 'Ut1fWU6XkqkMayHGnJZ', // Replace with your actual post ID
    'platforms' => ['bluesky', 'facebook', 'instagram', 'linkedin', 'reddit', 'tiktok', 'twitter', 'youtube'],
    'comment' => 'An amazing comment!'
]);

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $data
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

package main

import (
	"bytes"
	"encoding/json"
	"log"
	"net/http"
)

func main() {
	message := map[string]interface{}{
		"id":      "Ut1fWU6XkqkMayHGnJZ", // required
		"platforms": []string{"bluesky", "facebook", "instagram", "linkedin", "reddit", "tiktok", "twitter", "youtube"}, // required
		"comment": []string{"An amazing comment!"} // required
	}

	bytesRepresentation, err := json.Marshal(message)
	if err != nil {
		log.Fatalln(err)
	}

	req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/comments",
		bytes.NewBuffer(bytesRepresentation))

	req.Header.Add("Content-Type", "application/json; charset=UTF-8")
	req.Header.Add("Authorization", "Bearer API_KEY")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal("Error:", err)
	}

	res.Body.Close()
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace CommentsPOSTRequest_csharp
{
    class CommentsPOST
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/comments";

            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            string json = "{\"id\": \"Ut1fWU6XkqkMayHGnJZ\"," +
                "\"platforms\": [\"bluesky\", \"facebook\", \"instagram\", \"linkedin\", \"reddit\", \"tiktok\", \"twitter\", \"youtube\"]," +
                "\"comment\": [\"An amazing comment!\"]}";

            try
            {
                var content = new StringContent(json, Encoding.UTF8, "application/json");
                HttpResponseMessage response = await client.PostAsync(url, content);
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

200: Success

{
  "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"
  },
}

{
  "commentId": "5GizKtM9TFRFFWNDgBZ",
  "twitter": {
    "status": "success",
    "commentId": "1842266484032016",
    "comment": "Having a meeting on this",
    "platform": "twitter",
    "postUrl": "https://twitter.com/ayrshare/status/18422664840320"
  },
  "action": "post",
  "status": "error",
  "code": 156,
  "message": "Instagram is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
  "platform": "instagram",
  "id": "1w3QI6bU7KE9XyxrN0u", // Ayrshare Post ID
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 156,
      "message": "Facebook is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
      "platform": "facebook"
    },
    {
      "action": "post",
      "status": "error",
      "code": 156,
      "message": "Instagram is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
      "platform": "instagram"
    }
  ]
}

{
  "twitter": {
    "action": "post",
    "status": "error",
    "code": 134,
    "message": "The social network detected duplicate content and blocked this post. Please change the content and try again.",
    "post": "Having a meeting on this",
    "detail": "You are not allowed to create a Tweet with duplicate content."
  },
  "code": 134,
  "status": "error",
  "id": "1w3QI6bU7KE9XyxrN", // Ayrshare Post ID
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 134,
      "message": "The social network detected duplicate content and blocked this post. Please change the content and try again.",
      "post": "Having a meeting on this",
      "detail": "You are not allowed to create a Tweet with duplicate content.",
      "id": "1w3QI6bU7KE9XyxrN",
      "platform": "twitter"
    }
  ]
}

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:

• Bluesky mentions
• Facebook mentions
• Instagram mentions
• LinkedIn mentions
• Reddit mentions
• Threads mentions
• TikTok mentions
• X/Twitter mentions
• YouTube mentions

See Post Verification for the platform-by-platform mention rules and recommendations.

cURL

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

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/comments", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    id: "Ut1fWU6XkqkMayHGnJZ", // required
    platforms: ["bluesky", "facebook", "instagram", "linkedin", "reddit", "tiktok", "twitter", "youtube"], // required
    comment: "An amazing comment!", //required
  }),
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'id': 'Ut1fWU6XkqkMayHGnJZ',
        'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin', 'reddit', 'tiktok', 'twitter', 'youtube'],
        'comment': 'An amazing comment!'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/comments',
    json=payload,
    headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/comments';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$data = json_encode([
    'id' => 'Ut1fWU6XkqkMayHGnJZ', // Replace with your actual post ID
    'platforms' => ['bluesky', 'facebook', 'instagram', 'linkedin', 'reddit', 'tiktok', 'twitter', 'youtube'],
    'comment' => 'An amazing comment!'
]);

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $data
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

package main

import (
	"bytes"
	"encoding/json"
	"log"
	"net/http"
)

func main() {
	message := map[string]interface{}{
		"id":      "Ut1fWU6XkqkMayHGnJZ", // required
		"platforms": []string{"bluesky", "facebook", "instagram", "linkedin", "reddit", "tiktok", "twitter", "youtube"}, // required
		"comment": []string{"An amazing comment!"} // required
	}

	bytesRepresentation, err := json.Marshal(message)
	if err != nil {
		log.Fatalln(err)
	}

	req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/comments",
		bytes.NewBuffer(bytesRepresentation))

	req.Header.Add("Content-Type", "application/json; charset=UTF-8")
	req.Header.Add("Authorization", "Bearer API_KEY")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal("Error:", err)
	}

	res.Body.Close()
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace CommentsPOSTRequest_csharp
{
    class CommentsPOST
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/comments";

            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            string json = "{\"id\": \"Ut1fWU6XkqkMayHGnJZ\"," +
                "\"platforms\": [\"bluesky\", \"facebook\", \"instagram\", \"linkedin\", \"reddit\", \"tiktok\", \"twitter\", \"youtube\"]," +
                "\"comment\": [\"An amazing comment!\"]}";

            try
            {
                var content = new StringContent(json, Encoding.UTF8, "application/json");
                HttpResponseMessage response = await client.PostAsync(url, content);
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

200: Success

{
  "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"
  },
}

{
  "commentId": "5GizKtM9TFRFFWNDgBZ",
  "twitter": {
    "status": "success",
    "commentId": "1842266484032016",
    "comment": "Having a meeting on this",
    "platform": "twitter",
    "postUrl": "https://twitter.com/ayrshare/status/18422664840320"
  },
  "action": "post",
  "status": "error",
  "code": 156,
  "message": "Instagram is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
  "platform": "instagram",
  "id": "1w3QI6bU7KE9XyxrN0u", // Ayrshare Post ID
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 156,
      "message": "Facebook is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
      "platform": "facebook"
    },
    {
      "action": "post",
      "status": "error",
      "code": 156,
      "message": "Instagram is not linked. Please confirm the linkage on the Social Accounts page in the dashboard.",
      "platform": "instagram"
    }
  ]
}

{
  "twitter": {
    "action": "post",
    "status": "error",
    "code": 134,
    "message": "The social network detected duplicate content and blocked this post. Please change the content and try again.",
    "post": "Having a meeting on this",
    "detail": "You are not allowed to create a Tweet with duplicate content."
  },
  "code": 134,
  "status": "error",
  "id": "1w3QI6bU7KE9XyxrN", // Ayrshare Post ID
  "errors": [
    {
      "action": "post",
      "status": "error",
      "code": 134,
      "message": "The social network detected duplicate content and blocked this post. Please change the content and try again.",
      "post": "Having a meeting on this",
      "detail": "You are not allowed to create a Tweet with duplicate content.",
      "id": "1w3QI6bU7KE9XyxrN",
      "platform": "twitter"
    }
  ]
}