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

# Excluir comentários

> Exclui um único comentário ou todos os comentários de uma publicação

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

O endpoint de delete permite excluir comentários enviados via Ayrshare ou comentários que foram enviados fora do Ayrshare.

Consulte a [visão geral de Comments](/apis/comments/overview) para mais informações sobre os diferentes tipos de ID.

### Excluir comentários enviados pelo Ayrshare

Exclua um único comentário ou todos os comentários de uma publicação que foram enviados via Ayrshare.
Consulte o [Ayrshare Post ID](/apis/comments/overview#comments-with-ayrshare-post-id) e o [Ayrshare Comment ID](/apis/comments/overview#comments-with-ayrshare-comment-id) para mais informações.

Plataformas suportadas: Bluesky, Facebook, Instagram, LinkedIn, Reddit, TikTok, X/Twitter e YouTube.

### Excluir comentários enviados fora do Ayrshare

Exclua um comentário que não foi enviado via Ayrshare usando o `commentId` retornado para uma rede social específica.
Este é o [Social Comment ID](/apis/comments/overview#comments-with-social-comment-id) das redes sociais, não o ID do Ayrshare.

Plataformas suportadas: Facebook, Instagram, TikTok, X/Twitter e YouTube.

<Note>
  **TikTok — apenas comentários de autoria própria.** No TikTok, `DELETE /comments` só funciona para comentários criados pela própria conta autenticada do TikTok (por exemplo, respostas que você publicou via [endpoint de resposta](/apis/comments/reply-to-comment) do Ayrshare ou diretamente no app do TikTok). Tentar excluir um comentário criado por outro usuário — mesmo em um vídeo do qual você é dono — retorna Ayrshare `code: 328`. Se precisar moderar comentários de terceiros em seus próprios vídeos do TikTok, entre em contato com o suporte para confirmarmos o que está disponível para o seu tipo de conta vinculada.
</Note>

Por exemplo, você obtém todos os comentários de uma publicação específica do Instagram usando o endpoint [Get Comments](/apis/comments/get-comments) com `searchPlatformId` definido como `true`.

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

O JSON retornado terá um `commentId` para cada comentário, que você pode usar para excluir o comentário. Lembre-se de definir `searchPlatformId` como `true`.

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

## Parâmetros de cabeçalho

<HeaderAPI />

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  Excluir comentários enviados pelo Ayrshare:

  <ul className="custom-bullets">
    <li>Exclua todos os comentários enviados via Ayrshare fornecendo o [Ayrshare Post ID](/apis/comments/overview#comments-with-ayrshare-post-id).</li>
    <li>Exclua um único comentário fornecendo o [Ayrshare Comment ID](/apis/comments/overview#comments-with-ayrshare-comment-id).</li>
  </ul>

  Excluir um comentário enviado fora do Ayrshare:

  <ul className="custom-bullets">
    <li>
      Exclua um único comentário fornecendo o [Social Comment
      ID](/apis/comments/overview#comments-with-social-comment-id) da rede social.
    </li>

    <li>Deve incluir `searchPlatformId` definido como `true`.</li>
  </ul>
</ParamField>

## Parâmetros do corpo

<ParamField body="platforms" type="array">
  Obrigatório ao excluir comentários enviados via Ayrshare. As plataformas das quais excluir os comentários.

  Plataformas suportadas: `bluesky`, `facebook`, `instagram`, `linkedin`, `reddit`, `threads`, `tiktok`, `twitter`, `youtube`.

  ```json Deleting comments sent via Ayrshare theme={"system"}
  DELETE /comments/:id // Ayrshare Post ID or Ayrshare Comment ID
  {
    "platforms": ["bluesky", "facebook", "instagram", "linkedin", "reddit", "threads", "tiktok", "twitter", "youtube"]
  }
  ```
</ParamField>

<ParamField body="platform" type="string">
  Obrigatório ao excluir usando o [Social Comment
  ID](/apis/comments/overview#comments-with-social-comment-id), que é o `commentId` das
  redes sociais.

  Plataformas suportadas: `bluesky`, `facebook`, `instagram`, `threads`, `tiktok`, `twitter`, `youtube`. Apenas uma plataforma por vez é suportada.
</ParamField>

<ParamField body="searchPlatformId" type="boolean" default={false}>
  Obrigatório ao excluir usando o [Social Comment
  ID](/apis/comments/overview#comments-with-social-comment-id), que é o `commentId` das
  redes sociais; defina como `true`.

  ```json Deleting comments with Social Comment ID theme={"system"}
  DELETE /comments/:id // Social Comment ID
  {
    "searchPlatformId": true,
    // bluesky, facebook, instagram, threads, tiktok, twitter, youtube
    "platform": "facebook"
  }
  ```
</ParamField>

<ParamField body="hide" type="boolean" default={false}>
  Apenas TikTok. Defina como `true`, junto com `videoId`, para ocultar um comentário do TikTok dos espectadores públicos em vez de excluí-lo. A resposta de sucesso retorna `action: "hide"` e ecoa o comentário. Enviar `hide=true` sem `videoId` retorna HTTP `400`.

  Comentários ocultos permanecem visíveis para o dono do vídeo no TikTok Studio.

  ```json Hiding a TikTok comment theme={"system"}
  DELETE /comments/:id // Social Comment ID
  {
    "searchPlatformId": true,
    "platform": "tiktok",
    "hide": true,
    "videoId": "7303719953248109358"
  }
  ```
</ParamField>

<ParamField body="videoId" type="string">
  Obrigatório ao ocultar um comentário do TikTok (`hide=true`). O ID do vídeo do TikTok ao qual o comentário pertence.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl \
  -H "Authorization: Bearer API_KEY" \
  -X DELETE 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: "DELETE",
    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.delete('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'; // Replace with your post ID
  $apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

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

  $curl = curl_init($apiUrl);
  curl_setopt_array($curl, [
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'DELETE',
      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 CommentsDELETERequest_csharp
  {
      class CommentsDELETE
      {
          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.DeleteAsync(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 Single Comment theme={"system"}
  {
    "status": "success",
    "bluesky": {
      "action": "delete",
      "status": "success",
      "id": "at://did:plc:d/app.bsky.feed.post/3lez", // Bluesky Social Comment ID
      "comment": "This is a comment"
    },
    "facebook": {
      "action": "delete",
      "status": "success",
      "id": "938010233_939392023", // Facebook Social Comment ID
      "comment": "This is a comment"
    },
    "instagram": {
      "action": "delete",
      "status": "success",
      "id": "18010439663043269",  // Instagram Social Comment ID
      "comment": "This is a comment"
    },
    "linkedin": {
      "action": "delete",
      "status": "success",
      "id": "7133271664032669696", // LinkedIn Social Comment ID
      "comment": "This is a comment"
    },
    "threads": {
      "action": "delete",
      "status": "success",
      "id": "18064102964006231"   // Threads Social Comment ID
    },
    "tiktok": {
      "action": "delete",
      "status": "success",
      "commentId": "7303719953248109358", // Deprecated December 1, 2023. Use the id field instead.
      "id": "7303719953248109358", // TikTok Social Comment ID
      "comment": "This is a comment"
    },
    "twitter": {
      "action": "delete",
      "status": "success",
      "id": "1633128546494459904", // Twitter Social Comment ID
      "comment": "This is a comment"
    },
    "youtube": {
      "action": "delete",
      "status": "success",
      "id": "Ugy2m5u-LS9M29Gn3hd4AaABAg", // YouTub Social Comment ID
      "comment": "This is a comment"
    }
  }
  ```

  ```json 200: Sucesss Multiple Comments theme={"system"}
  {
    "status": "success",
    "linkedin": [
      {
        "action": "delete",
        "status": "success",
        "id": "7090782997972410368", // LinkedIn Social Comment ID
        "comment": "This is a comment"
      },
      {
        "action": "delete",
        "status": "success",
        "id": "7090783025164103680", // LinkedIn Social Comment ID
        "comment": "This is a comment"
      }
    ],
    "twitter": [
      {
        "action": "delete",
        "posts": [
          {
            "action": "delete",
            "status": "success",
            "id": "1685017310942134272", // Twitter Social Comment ID
            "comment": "This is a comment"
          }
        ]
      },
      {
        "action": "delete",
        "posts": [
          {
            "action": "delete",
            "status": "success",
            "id": "1685017338184146946", // Twitter Social Comment ID
            "comment": "This is a comment"
          }
        ]
      }
    ],
    "facebook": [
      {
        "action": "delete",
        "status": "success",
        "id": "676770944469840_644047184361660", // Facebook Social Comment ID
        "comment": "This is a comment"
      },
      {
        "action": "delete",
        "status": "success",
        "id": "676770944469840_983782432932944", // Facebook Social Comment ID
        "comment": "This is a comment"
      }
    ]
  }
  ```

  ```json 200: Success Hide TikTok Comment theme={"system"}
  {
    "status": "success",
    "tiktok": {
      "action": "hide",
      "status": "success",
      "id": "7303719953248109358", // TikTok Social Comment ID
      "comment": "This is a comment"
    }
  }
  ```

  ```json 400: Comment id not found theme={"system"}
  {
    "action": "comments",
    "status": "error",
    "code": 219,
    "message": "Error getting comments. Please verify the comments are still available."
  }
  ```
</ResponseExample>