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

# Огляд Comments API

> Публікація, відповіді, отримання та видалення коментарів до соціального посту

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} />

Ендпоінти Comments дозволяють вашим користувачам публікувати, відповідати, отримувати та видаляти коментарі до своїх постів.
Існує чотири типи ідентифікаторів коментарів: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID та Social Comment ID.
Кожен із цих ідентифікаторів використовується для різних цілей.

## Типи Comment ID

### Коментарі з Ayrshare Post ID

Типовий сценарій: коли ви публікуєте пост через Ayrshare, ви отримуєте Ayrshare Post ID.
Далі цей [Ayrshare Post ID](/apis/overview#ayrshare-post-id) можна використовувати для керування коментарями до цього посту.

Підтримувані платформи: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter та YouTube.

Наприклад:

<Steps>
  <Step title="Опублікуйте пост">
    Використайте ендпоінт [/post](/apis/post/post) для публікації посту через Ayrshare — його можна надіслати в кілька соцмереж одним викликом.

    У відповіді на верхньому рівні повертається [Ayrshare Post ID](/apis/overview#ayrshare-post-id).

    ```json {12} theme={"system"}
    {
        "status": "success",
        "errors": [],
        "postIds": [
        {
            "status": "success",
            "id": "106638148652329_591370753547555",
            "postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
            "platform": "facebook"
        }
        ],
        "id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
        "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
        "post": "What an amazing day",
        "validate": true
    }
    ```
  </Step>

  <Step title="Опублікуйте коментар">
    Використайте ендпоінт [/comments](/apis/comments/post-comment), щоб опублікувати коментар за Ayrshare Post ID.
    Коментар автоматично публікуватиметься в усіх соцмережах, де було опубліковано оригінальний пост.
    Наприклад, якщо ви опублікували пост у Facebook та Instagram, коментар з'явиться на обох платформах.

    ```http theme={"system"}
    POST https://api.ayrshare.com/api/comments/:id
    ```
  </Step>

  <Step title="Отримайте коментарі">
    Використайте ендпоінт [/comments](/apis/comments/get-comments), щоб отримати коментарі до посту за Ayrshare Post ID.
    Буде повернуто всі коментарі з усіх соцмереж, де було опубліковано пост.
    Наприклад, якщо ви публікували у Facebook та Instagram, ви отримаєте коментарі з обох платформ.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/:id
    ```
  </Step>
</Steps>

### Коментарі із Social Post ID

Іноді може виникнути потреба керувати коментарями до посту, який не було опубліковано через Ayrshare.
У такому разі використовуйте [Social Post ID](/apis/overview#social-post-id) — ID посту, присвоєний соцмережею.

<Note>
  Якщо пост було опубліковано через Ayrshare, використовуйте [Ayrshare Post
  ID](/apis/comments/overview#comments-with-ayrshare-post-id).
</Note>

Наприклад:

<Steps>
  <Step title="Отримайте історію постів">
    Спочатку отримайте пости Instagram, опубліковані поза межами Ayrshare, за допомогою ендпоінта [Get All Post History](/apis/history/history-platform).

    Ендпоінт повертає список постів із соціальним `id` посту.

    ```json {13} theme={"system"}
    {
        "status": "success",
        "posts": [
            {
                "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
                "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
                "commentsCount": 0,
                "created": "2022-05-20T17:26:03Z",
                "likeCount": 0,
                "mediaProductType": "FEED",
                "mediaType": "IMAGE",
                "username": "thegoodone",
                "id": "17833140557332933", // Instagram Social Post ID
                "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
                "post": "The #Mandalorian is on tonight instead of Friday",
                "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
            },
        ]
    }
    ```

    <Note>Соціальний `id` посту також повертається у полі `postIds` [ендпоінта post](/apis/post/post).</Note>
  </Step>

  <Step title="Отримайте коментарі до посту">
    Використайте повернутий `id`, щоб [отримати всі коментарі](/apis/comments/get-comments) для конкретного посту Instagram, вказавши соціальний `id`, `searchPlatformId` як `true` та `platform` як `instagram`.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true
    ```
  </Step>

  <Step title="Використайте Comment ID для отримання деталей коментаря">
    Повернутий JSON із попереднього кроку матиме `commentId` для кожного коментаря — це [social comment ID](/apis/overview#social-comment-id).

    ```json {5} theme={"system"}
    {
        "instagram": [
            {
                "comment": "What an amazing comment",
                "commentId": "17969247335804735", // Social Comment ID
                "created": "2024-11-26T11:49:00Z",
                "from": {
                "id": "103038435208332",
                "username": "john_smith"
                },
                "hidden": false,
                "likeCount": 3,
                "platform": "instagram",
                "postId": "18231730279304333",
                "username": "john_smith"
            }
        ]
    }

    ```
  </Step>
</Steps>

### Коментарі з Ayrshare Comment ID

Керуйте коментарями до посту, опублікованого через Ayrshare, за допомогою [Ayrshare Comment ID](/apis/overview#ayrshare-comment-id).
Ayrshare comment ID — це ID коментаря, присвоєний Ayrshare, який можна знайти в полі `commentId` у відповіді під час [публікації коментаря](/apis/comments/post-comment).

Часто використовується, якщо потрібно отримати деталі конкретного коментаря, опублікованого через Ayrshare.

### Коментарі із Social Comment ID

Керуйте коментарями до посту, який не було опубліковано через Ayrshare, за допомогою [Social Comment ID](/apis/overview#social-comment-id).
Social comment ID — це ID коментаря із соцмережі, а не Ayrshare ID; його можна знайти в полі `commentId` у відповіді під час [отримання коментарів](/apis/comments/get-comments).

```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true
```

Часто використовується для отримання деталей конкретного коментаря, опублікованого поза межами Ayrshare, — наприклад, відповідей на коментарі в LinkedIn.

## Вимкнення коментарів

Ви можете вимкнути коментарі під час публікації посту за допомогою поля `disableComments` в [ендпоінті /post](/apis/post/post). Коментарі будуть вимкнені лише для Instagram, LinkedIn та TikTok.

Ви також можете увімкнути або вимкнути коментарі до вже опублікованого посту за допомогою ендпоінта [update post](/apis/post/update-post) та поля `disableComments`.

## Обмеження платформ

<Note>
  **TikTok — `DELETE /comments` лише для власних коментарів.** [`DELETE /comments`](/apis/comments/delete-comments) у TikTok успішно виконується лише для коментарів, автором яких є сам автентифікований TikTok-акаунт (ваші власні відповіді). Спроба видалити коментар іншого користувача повертає Ayrshare `code: 328`. Для модерації сторонніх коментарів під вашими TikTok-відео зверніться до підтримки, щоб ми уточнили, що доступно для вашого типу підключеного акаунта.
</Note>

```
```
