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

# حذف التعليقات

> حذف تعليق واحد أو جميع التعليقات تحت منشور

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

تتيح لك نقطة نهاية الحذف حذف التعليقات المُرسلة عبر Ayrshare أو التعليقات التي أُرسلت خارج Ayrshare.

يُرجى الاطلاع على [نظرة عامة على التعليقات](/apis/comments/overview) لمزيد من المعلومات حول أنواع المعرّفات المختلفة.

### حذف التعليقات المُرسلة من Ayrshare

احذف إما تعليقًا واحدًا أو جميع التعليقات تحت منشور تم إرسالها عبر Ayrshare.
يُرجى الاطلاع على [معرّف منشور Ayrshare](/apis/comments/overview#comments-with-ayrshare-post-id) و[معرّف تعليق Ayrshare](/apis/comments/overview#comments-with-ayrshare-comment-id) لمزيد من المعلومات.

المنصات المدعومة: Bluesky وFacebook وInstagram وLinkedIn وReddit وTikTok وX/Twitter وYouTube.

### حذف التعليقات المُرسلة خارج Ayrshare

احذف تعليقًا لم يُرسَل عبر Ayrshare باستخدام `commentId` المُعاد لشبكة تواصل اجتماعي معينة.
هذا هو [معرّف التعليق الاجتماعي](/apis/comments/overview#comments-with-social-comment-id) من شبكات التواصل الاجتماعي، وليس معرّف Ayrshare.

المنصات المدعومة: Facebook وInstagram وTikTok وX/Twitter وYouTube.

<Note>
  **TikTok — التعليقات التي تكتبها بنفسك فقط.** على TikTok، تنجح `DELETE /comments` فقط للتعليقات التي كتبها حساب TikTok المُصادق عليه ذاته (مثل الردود التي نشرتها عبر [نقطة نهاية الرد](/apis/comments/reply-to-comment) في Ayrshare أو مباشرةً داخل تطبيق TikTok). محاولة حذف تعليق كتبه مستخدم آخر — حتى ولو كان على فيديو تملكه — تُرجع رمز Ayrshare `code: 328`. إذا كنت بحاجة إلى إدارة تعليقات طرف ثالث على مقاطع فيديو TikTok الخاصة بك، فاتصل بالدعم لكي نتمكن من تأكيد ما هو متاح لنوع حسابك المربوط.
</Note>

على سبيل المثال، تحصل على جميع التعليقات لمنشور Instagram معيّن باستخدام نقطة نهاية [الحصول على التعليقات](/apis/comments/get-comments) مع تعيين `searchPlatformId` إلى `true`.

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

سيحتوي JSON المُعاد على `commentId` لكل تعليق، والذي يمكنك استخدامه لحذف التعليق. تذكّر تعيين `searchPlatformId` إلى `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"
    }
  ]
}
```

## معاملات الترويسة

<HeaderAPI />

## معاملات المسار

<ParamField path="id" type="string" required>
  حذف تعليقات مُرسلة من Ayrshare:

  <ul className="custom-bullets">
    <li>احذف جميع التعليقات المُرسلة عبر Ayrshare بتقديم [معرّف منشور Ayrshare](/apis/comments/overview#comments-with-ayrshare-post-id).</li>
    <li>احذف تعليقًا واحدًا بتقديم [معرّف تعليق Ayrshare](/apis/comments/overview#comments-with-ayrshare-comment-id).</li>
  </ul>

  حذف تعليق مُرسَل خارج Ayrshare:

  <ul className="custom-bullets">
    <li>
      احذف تعليقًا واحدًا بتقديم [معرّف التعليق
      الاجتماعي](/apis/comments/overview#comments-with-social-comment-id) من شبكة التواصل الاجتماعي.
    </li>

    <li>يجب تضمين `searchPlatformId` مُعيّنًا إلى `true`.</li>
  </ul>
</ParamField>

## معاملات النص

<ParamField body="platforms" type="array">
  مطلوب عند حذف التعليقات المُرسلة عبر Ayrshare. المنصات التي ستُحذف منها التعليقات.

  المنصات المدعومة: `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">
  مطلوب عند الحذف باستخدام [معرّف التعليق
  الاجتماعي](/apis/comments/overview#comments-with-social-comment-id)، وهو `commentId` من
  شبكات التواصل الاجتماعي.

  المنصات المدعومة: `bluesky` و`facebook` و`instagram` و`threads` و`tiktok` و`twitter` و`youtube`. يُدعم منصة واحدة فقط في كل مرة.
</ParamField>

<ParamField body="searchPlatformId" type="boolean" default={false}>
  مطلوب عند الحذف باستخدام [معرّف التعليق
  الاجتماعي](/apis/comments/overview#comments-with-social-comment-id)، وهو `commentId` من
  شبكات التواصل الاجتماعي، مُعيّنًا إلى `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}>
  TikTok فقط. عيّن إلى `true`، مع `videoId`، لإخفاء تعليق TikTok عن المشاهدين العامّين بدلًا من حذفه. تُرجع استجابة النجاح `action: "hide"` وتُعيد صدى التعليق. إرسال `hide=true` بدون `videoId` يُرجع HTTP `400`.

  تظل التعليقات المخفية مرئية لمالك الفيديو في 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">
  مطلوب عند إخفاء تعليق TikTok (`hide=true`). معرّف فيديو TikTok الذي ينتمي إليه التعليق.
</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>