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

# البحث في صوتيات Instagram

> ابحث في كتالوج الصوت المرخّص في Instagram عن مقطع لإرفاقه بـ Reel

export const InstagramAudioNotice = () => <Warning>
  <strong>Requires Instagram linked through Facebook Login.</strong> Instagram's Audio API is only available to accounts connected via <strong>Facebook Login</strong>, which needs a Facebook Page connected to the Instagram account. Accounts connected with <strong>Instagram Login</strong> (the Ayrshare default) cannot search, look up, or attach audio, and every audio request returns <code>code: 514</code>.
  <br /><br />
  This is a Meta restriction, not an Ayrshare one. Meta's documentation states the Audio API "is only available on the Instagram API with Facebook Login. It is not supported on the Instagram API with Instagram Login." No permission or plan upgrade changes it.
  <br /><br />
  <strong>Three things are required:</strong>
  <br />
  1. An Instagram <strong>Business</strong> or <strong>Creator</strong> account<br />
  2. A <strong>Facebook Page connected</strong> to that Instagram account<br />
  3. Instagram linked to Ayrshare with <strong>Instagram Login disabled</strong>, so the Facebook Login flow is used
  <br /><br />
  See the <a href="/docs/dashboard/connect-social-accounts/instagram#music-attach-eligibility-facebook-login-required">step-by-step setup guide</a>.
</Warning>;

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

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/docs/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="/docs/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="/docs/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

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

ابحث في كتالوج الصوت في Instagram بكلمة مفتاحية. استخدم `audioId` المُعاد مع [`instagramOptions.audioConfiguration`](/docs/apis/post/social-networks/instagram#adding-music-to-a-reel) لإرفاق المقطع عند نشر Reel.

<InstagramAudioNotice />

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

<HeaderAPI />

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

<ParamField query="query" type="string" required>
  كلمة مفتاحية للبحث عنها، مثل اسم فنان أو مقطع. القيمة الفارغة أو المكوّنة من مسافات فقط تعيد
  `code: 101`.
</ParamField>

<ParamField query="audioType" type="string" default="music">
  الكتالوج الذي يجري البحث فيه. إمّا `music` للمقاطع التجارية المرخّصة أو `original_sound` للصوت
  المأخوذ من Reels منشئين آخرين. أي قيمة أخرى تعيد `code: 101`.
</ParamField>

<ParamField query="limit" type="integer">
  الحد الأقصى لعدد المقاطع المُعادة، من `1` إلى `100`. القيم غير الصحيحة أو الخارجة عن النطاق تعيد
  `code: 101`. عند إغفاله، يُطبَّق الإعداد الافتراضي الخاص بـ Instagram.
</ParamField>

## حقول الاستجابة

لا يعيد Instagram كل حقل لكل مقطع، لذا تعامل مع جميع حقول المقطع باستثناء `audioId` على أنها اختيارية.

<ResponseField name="status" type="string">
  `success` عند اكتمال البحث. عدم وجود تطابق في الكتالوج لا يزال نجاحًا.
</ResponseField>

<ResponseField name="query" type="string">
  الكلمة المفتاحية التي جرى البحث عنها، مُعادة كما هي.
</ResponseField>

<ResponseField name="audio" type="array">
  المقاطع المطابقة. المصفوفة الفارغة تعني أن البحث جرى ولم يطابق شيئًا.

  <Expandable title="حقول المقطع">
    <ResponseField name="audioId" type="string">
      المعرّف الذي يُمرَّر كـ `audioConfiguration.audioId` عند نشر Reel.
    </ResponseField>

    <ResponseField name="title" type="string">عنوان المقطع.</ResponseField>
    <ResponseField name="displayArtist" type="string">اسم الفنان كما يعرضه Instagram.</ResponseField>
    <ResponseField name="durationMs" type="integer">طول المقطع بالمللي ثانية.</ResponseField>
    <ResponseField name="thumbnailUrl" type="string">عنوان URL للصورة المصغّرة لغلاف المقطع.</ResponseField>
    <ResponseField name="audioType" type="string">إمّا `music` أو `original_sound`.</ResponseField>

    <ResponseField name="isAdsEligible" type="boolean">
      ما إذا كان يمكن استخدام المقطع في إعلان. كثيرًا ما تكون الموسيقى المرخّصة غير متاحة للإعلانات
      حتى عندما تكون متاحة لـ Reel عضوي.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200: Success theme={"system"}
  {
    "status": "success",
    "query": "summer",
    "audio": [
      {
        "audioId": "17901234567890123",
        "title": "Summer Nights",
        "displayArtist": "The Example Band",
        "durationMs": 32000,
        "thumbnailUrl": "https://scontent.example.com/cover.jpg",
        "audioType": "music",
        "isAdsEligible": true
      }
    ]
  }
  ```

  ```json 200: No matches theme={"system"}
  {
    "status": "success",
    "query": "asdfghjkl",
    "audio": []
  }
  ```

  ```json 400: Instagram Login account theme={"system"}
  {
    "status": "error",
    "code": 514,
    "action": "post",
    "message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
    "platform": "instagram"
  }
  ```
</ResponseExample>

## الأخطاء

| الرمز | المعنى                                                                                                                                     |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| 101   | `query` مفقود أو فارغ، أو `audioType` غير متعارف عليه، أو `limit` خارج النطاق من 1 إلى 100.                                                |
| 156   | Instagram غير مرتبط بملف التعريف هذا.                                                                                                      |
| 161   | انتهت صلاحية تفويض Instagram أو أُلغي. أعد ربط الحساب.                                                                                     |
| 239   | رفض Instagram الطلب لسبب على مستوى الحساب، بما في ذلك مقطع غير متاح. في البحث يُبلَّغ عن 239 بدلًا من 517 الذي تعيده نقطة نهاية الاستعلام. |
| 258   | أعاد Instagram استجابة مشوّهة أو فشلًا غير مُطابَق.                                                                                        |
| 425   | يفتقر الاتصال إلى إذن Instagram مطلوب. أعد الربط وامنح جميع الأذونات.                                                                      |
| 435   | تم بلوغ حد المعدّل الخاص بـ Instagram. انتظر قبل إعادة المحاولة.                                                                           |
| 514   | Instagram مرتبط بواسطة Instagram Login. يتطلّب Audio API استخدام Facebook Login.                                                           |

الرموز من 514 إلى 518 موصوفة في [أخطاء صوت Instagram Reels](/docs/errors/errors-ayrshare#instagram-reels-audio-errors)؛ أما البقية ففي [مرجع أخطاء Ayrshare](/docs/errors/errors-ayrshare).

## الخطوات التالية

<Card title="إرفاق المقطع بـ Reel" icon="music" href="/docs/apis/post/social-networks/instagram#adding-music-to-a-reel" horizontal />

<Card title="الاستعلام عن مقطع واحد" icon="magnifying-glass" href="/docs/apis/media/get-instagram-audio" horizontal />