> ## 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.

# Lấy Bình luận

> Lấy các bình luận cho một post ID cấp cao nhất

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

<XByoNotice />

Lấy các bình luận cho một bài đăng bằng cách sử dụng Ayrshare post ID, Social Post ID, Ayrshare Comment ID, hoặc Social Comment ID với Comment API.

Vui lòng xem [Tổng quan về Comments](/apis/comments/overview) để biết thêm thông tin về các loại ID khác nhau.

<Tip>Nếu sử dụng Ayrshare Post ID thì không yêu cầu tham số query nào.</Tip>

## Chi tiết Bình luận Bổ sung

<ul class="custom-bullets">
  <li>
    Dữ liệu bình luận được cập nhật mỗi 10 phút cho tất cả các nền tảng, ngoại trừ X. Do các
    hạn chế do X API áp đặt, dữ liệu bình luận cho X được làm mới bằng chiến lược exponential
    backoff, có nghĩa là khoảng thời gian giữa các lần cập nhật dần tăng lên theo thời gian.
  </li>

  <li>Trong phản hồi Facebook, các câu trả lời bình luận cho các câu trả lời luôn có cùng `parent.id`.</li>

  <li>
    Truy xuất các câu trả lời LinkedIn cho các bình luận bằng cách đặt các tham số query `"commentId": true` và
    `"searchPlatformId": true` và cung cấp [Social Comment
    ID](/apis/comments/overview#comments-with-social-comment-id) trong tham số path.
  </li>

  <li>
    Facebook và Instagram trả về tối đa 1.000 bình luận gần đây nhất trên một bài đăng. Vui lòng liên hệ với chúng tôi
    về các giới hạn cao hơn trên gói Enterprise.
  </li>

  <li>
    Đối với một bài đăng TikTok vẫn đang được xử lý (`id` của nó là `"pending"`), get-comments trả về một lỗi
    "still processing" rõ ràng ([`code: 288`](/errors/errors-ayrshare#tiktok-comment-errors), HTTP `400`)
    thay vì một lỗi chung chung. Thử lại sau khi [`tikTokPublished`
    webhook](/apis/post/social-networks/tiktok#tiktok-processing) kích hoạt hoặc
    [/history](/apis/history/overview) hiển thị video id đã được phân giải.
  </li>
</ul>

## Tham số Header

<HeaderAPI />

## Tham số Path

<ParamField path="id" type="string" required>
  [Ayrshare Post ID](/apis/comments/overview#comments-with-ayrshare-post-id), [Social Post
  ID](/apis/comments/overview#comments-with-social-post-id), hoặc [Social Comment
  ID](/apis/comments/overview#comments-with-social-comment-id).
</ParamField>

## Tham số Query

<ParamField query="searchPlatformId" type="boolean" default={false}>
  Nếu lấy bình luận trên một bài đăng được xuất bản qua Ayrshare và sử dụng [Ayrshare Post
  ID](/apis/comments/overview#comments-with-ayrshare-post-id), không bao gồm trường này - nó
  mặc định là `false`. Nếu lấy bình luận sử dụng [Social Post
  ID](/apis/comments/overview#comments-with-social-post-id) hoặc [Social Comment
  ID](/apis/comments/overview#comments-with-social-comment-id), là ID được tạo bởi các
  mạng xã hội, đặt thành `true`.
</ParamField>

<ParamField query="commentId" type="boolean" default={false}>
  Nếu lấy bình luận sử dụng [Social Comment ID](/apis/overview#social-comment-id), là
  ID bình luận được tạo bởi các mạng xã hội, đặt thành `true`.

  Nếu lấy bình luận sử dụng Ayrshare Post ID hoặc Social Post ID, không bao gồm trường này - nó mặc định là `false`.

  <Note>Nếu sử dụng tham số query `commentId`, bạn cũng phải đặt `searchPlatformId` thành `true`.</Note>
</ParamField>

<ParamField query="platform" type="string">
  Bắt buộc nếu `searchPlatformId` hoặc `commentId` là `true`.

  Khi nào sử dụng:

  <ul class="custom-bullets">
    <li>
      Nếu sử dụng [Social Post ID](/apis/comments/overview#comments-with-social-post-id) và
      trường `"searchPlatformId": true`. Các nền tảng được hỗ trợ: `bluesky`, `facebook`, `instagram`,
      `linkedin`, `threads`, `tiktok`, `twitter`, `youtube`.
    </li>

    <li>
      Nếu sử dụng [Social Comment ID](/apis/comments/overview#comments-with-social-comment-id) và
      các trường `"searchPlatformId": true` và `"commentId": true`. Các nền tảng được hỗ trợ: `facebook`,
      `instagram`, `linkedin`.
    </li>

    <li>
      Nếu sử dụng [Ayrshare Post ID](/apis/comments/overview#comments-with-ayrshare-post-id), không
      bao gồm trường này - các bình luận sẽ được trả về từ tất cả các nền tảng nơi bài đăng gốc đã được
      xuất bản.
    </li>
  </ul>
</ParamField>

## Ví dụ Yêu cầu GET Bình luận

<CodeGroup>
  ```json With Ayrshare Post ID theme={"system"}
  // Ayrshare Post ID
  GET /comments/:id
  ```

  ```json With Social Post ID theme={"system"}
  // Social Post ID
  // Platforms: facebook, instagram, linkedin, tiktok, twitter, youtube
  GET /comments/:id?searchPlatformId=true&platform=facebook
  ```

  ```json With Social Comment ID theme={"system"}
  // Social Comment ID
  // Platforms: facebook, instagram, linkedin
  GET /comments/:id?commentId=true&searchPlatformId=true&platform=facebook
  ```
</CodeGroup>

<RequestExample>
  ```bash cURL theme={"system"}
  curl \
  -H "Authorization: Bearer API_KEY" \
  -X GET https://api.ayrshare.com/api/comments/Ut1fWU6XkqkMayHGnJZ
  ```

  ```javascript JavaScript theme={"system"}
  const API_KEY = "API_KEY";

  fetch("https://api.ayrshare.com/api/comments/Ut1fWU6XkqkMayHGnJZ",
      {
          method: "GET",
          headers: {
              Authorization: `Bearer ${API_KEY}`,
          },
      })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);
  ```

  ```python Python theme={"system"}
  import requests

  headers = {'Authorization': 'Bearer API_KEY'}

  r = requests.get('https://api.ayrshare.com/api/comments/Ut1fWU6XkqkMayHGnJZ', headers=headers)

  print(r.json())
  ```

  ```php PHP theme={"system"}
  <?php

  $apiUrl = 'https://api.ayrshare.com/api/comments/Ut1fWU6XkqkMayHGnJZ'; // Thay thế bằng ID bài đăng của bạn
  $apiKey = 'API_KEY';  // Thay thế 'API_KEY' bằng khóa API thực tế của bạn

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

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

  $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);
  ```

  ```csharp C# theme={"system"}
  using System;
  using System.Net.Http;
  using System.Threading.Tasks;

  namespace CommentsGETRequest_csharp
  {
      class CommentsGET
      {
          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/Ut1fWU6XkqkMayHGnJZ";

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

              try
              {
                  HttpResponseMessage response = await client.GetAsync(url);
                  response.EnsureSuccessStatusCode();
                  string responseBody = await response.Content.ReadAsStringAsync();
                  Console.WriteLine(responseBody);
              }
              catch (HttpRequestException e)
              {
                  Console.WriteLine($"Error: {e.Message}");
              }
          }
      }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200: Success {2, 19, 60, 99, 141, 156, 194, 229, 280} theme={"system"}
  {
      "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",
  }
  ```

  ```javascript 404: Comments Not Found theme={"system"}
  {
      "action": "post",
      "status": "error",
      "code": 186,
      "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent.",
      "id": "Ut2fWU6XkqkMayHGnJZ7"
  }
  ```
</ResponseExample>
