Get Comments

Get the comments for a given top-level post ID

Available on Premium, Business, Enterprise plans.

Get comments for a post using the Ayrshare post ID, Social Post ID, Ayrshare Comment ID, or Social Comment ID with the Comment API.

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

If using the Ayrshare Post ID no query parameters are required.

Additional Comment Details

• Comment data is updated every 10 minutes for all platforms, with the exception of X. Due to restrictions imposed by the X API, the comment data for X is refreshed using an exponential backoff strategy, meaning the intervals between updates gradually increase over time.

• In the Facebook response, comment replies to replies always have the same parent.id.

• Retrieve LinkedIn replies to comments by setting the "commentId": true and "searchPlatformId": true query parameters and providing the Social Comment ID in the path parameter.

• Facebook and Instagram return up to the most recent 1,000 comments on a post. Please contact us regarding higher limits on the Enterprise plan.

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

id · string · required

Ayrshare Post ID, Social Post ID, or Social Comment ID.

Query Parameters

searchPlatformId · boolean · default: false

If getting comments on a post published via Ayrshare and using the Ayrshare Post ID, do not include this field - it defaults to false. If getting comments using the Social Post ID or Social Comment ID, which is the ID generated by the social networks, set to true.

commentId · boolean · default: false

If getting comments using the Social Comment ID, which is the comment ID generated by the social networks, set to true.

If getting comment using the Ayrshare Post ID or Social Post ID, do not include this field - it defaults to false.

If using the commentId query parameter, you must also set searchPlatformId to true.

platform · string

Required if searchPlatformId or commentId is true.

When to use:

• If using the Social Post ID and "searchPlatformId": true field. Supported platforms: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.

• If using the Social Comment ID and "searchPlatformId": true and "commentId": true fields. Supported platforms: facebook, instagram, linkedin.

• If using the Ayrshare Post ID, do not include this field - comments will be returned from all platforms where the original post was published.

Comment GET Request Examples

With Ayrshare Post ID

// Ayrshare Post ID
GET /comments/:id

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/comments/Ut1fWU6XkqkMayHGnJZ

200: Success

{
    "bluesky": [
        {
            "comment": "Nice one this is",
            "commentId": "at://did:plc:62musrcyanhro2lydyhlw7ci/app.bsky.feed.post/3lf4b4j3dqy2i",
            "created": "2025-01-06T23:12:58.950Z",
            "displayName": "Ayrshare",
            "likeCount": 0,
            "platform": "bluesky",
            "profileImageUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:62musrcyanhro2lydyhlw7ci/bafkreiegtpqhpwgu6tww2ejsdil4ew3blmt6jh3wlq6zhanxo3wj2ib4du@jpeg",
            "quoteCount": 0,
            "replies": [],
            "replyCount": 0,
            "replyTo": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx45723",
            "repostCount": 0,
            "userName": "ayrshare.com"
        }
    ],
    "facebook": [
        {    // The most recent 1,000 comments retrieved.
            "comment": "What a great comment",
            "commentId": "806720068141593_1849585385469876", // Facebook Social Comment ID
            "commentCount": 1, // The number of replies to the comment
            "commentUrl": "https://www.facebook.com/106148652329/posts/184958538876/", // URL to the comment
            "created": "2024-02-27T19:55:28Z",
            "from": {  // If available. Facebook determines availability based on the user's security profile and settings.
                "name": "John Smith",
                "id": "5075334022535844"
            },
            "likeCount": 342,
            "platform": "facebook",
            "userLikes": false,
            "replies": [ // Facebook replies to replies have the same parent id regardless of nesting.
                {
                    "comment": "Nice Comment 2",
                    "commentId": "806720068141593_320599703877348",
                    "commentCount": 0,
                    "company": true,
                    "created": "2024-02-27T19:55:40Z",
                    "from": {
                        "name": "Sue Me",
                        "id": "5075334022535800"
                    },
                    "likeCount": 3,
                    "parent": {
                        "createdTime": "2024-02-27T19:55:28+0000",
                        "from": {
                            "name": "John Smith",
                            "id": "5075334022535844"
                        },
                        "message": "What a great comment",
                        "id": "806720068141593_1849585385469876"
                    },
                    "platform": "facebook",
                    "userLikes": false
                }
            ]
        }
    ],
    "instagram": [
        {    // The most recent 1,000 comments retrieved.
            "comment": "Love this post.",
            "commentId": "18030599567251077", // Instagram Social Comment ID
            "created": "2022-10-13T00:52:47Z",
            "from": {                    // If available. Instagram determines availability based on the user's security profile and settings.
                "name": "WondrousTimes",
                "id": "112775157855689"
            },
            "hidden": false,    // Is the comment hidden
            "likeCount": 1,
            "parentId": "17999860012861", // The Instagram Social Post ID of the parent post. Only returned when using get by ID on a reply.
            "platform": "instagram",
            "postId": "18011025266302661", // The Instagram top level post ID (original post). 
            "replies": [
                {
                    "comment": "@ayrshare Thanks",
                    "created": "2024-04-04T22:37:39Z",
                    "from": {
                        "id": "178414522127073334",
                        "username": "ayrshare"
                    },
                    "hidden": false,
                    "id": "18023114651100610", // Instagram Social Comment Id
                    "likeCount": 2,
                    "parentId": "18030599567251077",
                    "user": {
                        "id": "17841452212702234"
                    },
                    "username": "ayrshare"
                }
            ],
            "user": {        // ID of Instagram user who created the comment.
                "id": "112775157855689"
            },
            "userName": "ayrshare" // If available. Instagram determines availability based on the user's security profile and settings.
        }
    ],
    // Retrieve LinkedIn replies to comments by using the commentID with the Get Comments with Social Comment ID endpoint.
    "linkedin": [
        {
            "comment": "New wonderful comment",
            "commentId": "6961077099692445688", // LinkedIn Social Comment ID
            "commentUrn": "urn:li:comment:(urn:li:activity:7141202289402236928,7141205176207503360)", // Social comment id from LinkedIn
            "created": "2022-08-04T21:55:11Z",
            "from": {
                "name": "Sue Smith",
                "id": "yb8P0Oq5l8",
                "url": "https://www.linkedin.com/in/suesmith",
                "description": "Co-Founder at Smiths"
            },
            "likeCount": 34,
            "media": [
                {
                    "type": "image",
                    "url": "https://media-exp1.licdn.com/dms/image/D4E2CAQH4RRMRaJSR"
                }
            ],
            "platform": "linkedin",
            "profileImageUrl": "https://media-exp1.licdn.com/dms/image/C5103AQHORT70jVfK",
            "userName": "suesmith"
        },
        {   // Comment from a company
            "comment": "Love it",
            "commentId": "urn:li:comment:(urn:li:activity:71860989603258818,7186100659052515329)",
            "commentUrn": "urn:li:comment:(urn:li:activity:71860989603258818,7186100659052515329)",
            "created": "2024-04-16T20:38:28Z",
            "founded": 2020,
            "from": {
                "name": "Ayrshare",
                "id": 22327643,
                "url": "https://www.linkedin.com/company/22327643",
                "description": "Social Media API"
            },
            "likeCount": 123,
            "organizationType": "PRIVATELY_HELD",
            "platform": "linkedin",
            "userName": "ayrshare",
            "website": "https://www.ayrshare.com"
        }
    ],
    "reddit": [
        {
            "comment": "Nice comment",
            "commentId": "kaxeilk",
            "created": "2023-11-27T03:09:06.000Z",
            "from": {
                "name": "suppercomment",
                "id": "t2_3zaxa"
            },
            "commentUrl": "/r/test/comments/184szm7/reddit_post_title/kaxeilk/",
            "subreddit": "test",
            "ups": 1,
            "isSubmitter": true
        }
    ],
    "threads": [
        {
            "comment": "An amazing comment!",
            "commentId": "17890924860234841",
            "commentUrl": "https://www.threads.com/@ayrshare/post/DI4pRHAto1",
            "created": "2025-04-25T21:43:57+0000",
            "hasReplies": false,
            "isQuotePost": false,
            "isReply": true,
            "isReplyOwnedByMe": true,
            "mediaType": "text_post",
            "parentId": "17890643139123706",
            "platform": "threads",
            "postId": "17890643139123706",
            "replies": [
                {
                    "comment": "sweet",
                    "commentId": "17961516995911683",
                    "commentUrl": "https://www.threads.com/@ayrshare/post/DI4shgspzI1",
                    "created": "2025-04-25T22:12:22+0000",
                    "hasReplies": false,
                    "isQuotePost": false,
                    "isReply": true,
                    "isReplyOwnedByMe": true,
                    "mediaType": "text_post",
                    "parentId": "17890924860234841",
                    "platform": "threads",
                    "postId": "17890643139123706",
                    "replyAudience": "everyone",
                    "shortcode": "DI4shgspzI1",
                    "userName": "ayrshare"
                }
            ],
            "replyAudience": "everyone",
            "shortcode": "DI4pRHAtoVu",
            "userName": "ayrshare"
        }
    ],
    "tiktok": [
        {
            "comment": "The best comment",
            "commentId": "7260964914699764523", // TikTok Social Comment ID
            "created": "2023-07-28T20:12:23Z",
            "displayName": "John Smith",
            "liked": false,     // Whether the user who posted the video has liked the comment.
            "likeCount": 24,
            "owner": true,      // Whether the user who posted the video made the comment.
            "pinned": false,    // If the comment is pinned
            "platform": "tiktok",
            "profileImageUrl": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f123c4b57",
            "replies": [
                {
                    "comment": "One reply",
                    "commentId": "72776074297628920", // TikTok Social Comment ID
                    "createTime": "2023-09-11 16:34:20",
                    "liked": false,    // Whether the user who posted the video has liked the comment reply.
                    "likes": 0,
                    "owner": false,    // Whether the user who posted the video made the comment reply.
                    "parentCommentId": "72776073973290774", // TikTok Parent Social Comment ID
                    "profileImageUrl": "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/bcc6e6778x168.jpeg",
                    "status": "PUBLIC",
                    "userId": "51e0cb95a8b14f0f1020aa017",
                    "username": "ayrshare",
                    "videoId": "7260964048362310958"  // TikTok Social Post ID
                }
            ],
            "status": "success",
            "userId": "fc904564301a6d383fd19bd4982ba2682404876533c04741a8c3f270376cd3dd",
            "username": "helmar1066",
            "videoId": "7260964048362310958", // TikTok Social Post ID
            "visibility": "public"
        }
    ],
    "twitter": [
        {
            "bookmarkCount": 2,
            "comment": "@ayrshare Congrats on this",
            "commentId": "1505595871831891068", // Twitter Social Comment ID
            "created": "2022-05-14T21:56:14.000Z",
            "description": "Eat great!",
            "id": "1552209331030036480",    // Twitter Social Post ID
            "impressionCount": 134,
            "likeCount": 341,
            "name": "waffles",
            "platform": "twitter",
            "profileImageUrl": "https://pbs.twimg.com/profile_images/119426890464/lvQZPpt4_normal.png",
            "publicMetrics": {  // X public metrics of the user who posted the comment
                "followersCount": 56,
                "followingCount": 2242,
                "tweetCount": 32,
                "listedCount": 3,
                "likeCount": 459,
                "mediaCount": 244
            },
            "quoteCount": 2,
            "referencedTweets": [   // ID of the tweet that was replied to
                {
                    "type": "replied_to",
                    "id": "187203972440121733"
                }
            ],
            "replyCount": 3,
            "replyTo": {             // Who the comment was in reply to
                "createdAt": "2012-01-18T21:13:15.000Z",
                "description": "Social Media API",
                "id": "467793290",
                "location": "New York City",
                "name": "Ayrshare",
                "profileImageUrl": "https://pbs.twimg.com/profile_images/1851502252/ayrshare_normal.gif",
                "publicMetrics": {  // X public metrics of the user who the comment was in reply to
                    "followersCount": 46,
                    "followingCount": 1242,
                    "tweetCount": 12,
                    "listedCount": 2,
                    "likeCount": 439,
                    "mediaCount": 144
                },
                "url": "https://t.co/GQgCqytA",
                "username": "anotherone"
            },
            "threadNumber": 1,     // If thread, number in sequence
            "userName": "waffles"
        }
    ],
    "youtube": [
        {
            "channelUrl": "http://www.youtube.com/channel/sp0CnxiNbUU0AJtuYKZwXQ",
            "comment": "Two comments",
            "commentId": "Ugx0tiPuoUpXfrY0qvV4AaABAg", // YouTube Social Comment ID
            "created": "2022-05-24T19:45:49Z",
            "isPublic": true, // This setting indicates whether the comment, including all of its comments and comment replies, is visible to all YouTube users.
            "likeCount": 34,
            "platform": "youtube",
            "profileImageUrl": "https://yt3.ggpht.com/ytc/AKedOLT2hOZirBUGodAg31-QXaGPd9DmrkxR48UXAw=s48-c-k-c0x00ffffff-no-rj",
            "replies": [
                {
                    "comment": "amazing reply",
                    "commentId": "UgzJFjmrrRUr6nsRWi14AaABAg.9ssbUo6Es1n9ssbVwRn2iz",
                    "created": "2023-08-01T15:59:16Z",
                    "likeCount": 2,
                    "platform": "youtube",
                    "userName": "uman",
                    "profileImageUrl": "https://yt3.ggpht.com/ytc/AOPcoUDV_W7h3ZSEcFYrcEuXUPxVCTuF4NTw=s48-c-k-c0x00ffffff-no-rj",
                    "channelUrl": "http://www.youtube.com/channel/sp0CnxiNbUU0AJtuYKZwXQ",
                    "parentId": "UgzJFjmrrRUr6nsRWi14AaABAg"
                }
            ],
            "userName": "ayrshare"
        },
        {
            "channelUrl": "http://www.youtube.com/channel/sp0CnxiNbUU0AJtuYKZwXQ",
            "comment": "One comment",
            "commentId": "Ugx0tiPuoUpXfrY0qvV4AaABAa", // YouTube Social Comment ID
            "created": "2022-05-24T19:00:10Z",
            "isPublic": true, // This setting indicates whether the comment, including all of its comments and comment replies, is visible to all YouTube users.
            "likeCount": 123,
            "platform": "youtube",
            "profileImageUrl": "https://yt3.ggpht.com/ytc/AAKedOLT2hOZirBUGodAg31-QXaGPd9DmrkxR48UXAw=s48-c-k-c0x00ffffff-no-rj",
            "userName": "ayrshare"
        }
    ],
    "status": "success",
    "id": "Ut2fWU6XkqkMayHGnJZ7",
    "lastUpdated": "2023-03-26T22:30:13.035Z",
    "nextUpdate": "2023-03-26T22:41:13.035Z",
}