> ## 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 Audio Metadata प्राप्त करें

> किसी एक Instagram audio track का विवरण उसकी id से लुकअप करें

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

किसी एक audio track का विवरण उसकी `audioId` से पुनर्प्राप्त करें। इसका उपयोग यह पुष्टि करने के लिए करें कि कोई stored id अभी भी वैध है, या publish करने से पहले track का शीर्षक और artwork दिखाने के लिए।

<InstagramAudioNotice />

## Header Parameters

<HeaderAPI />

## Path Parameters

<ParamField path="audioId" type="string" required>
  Track id, जैसा [audio खोज](/docs/apis/media/search-instagram-audio) द्वारा लौटाया गया। ऐसी id जिसे
  Instagram नहीं पहचानता, `code: 517` लौटाती है।
</ParamField>

## Response Fields

Track की फ़ील्ड nested होने के बजाय प्रतिक्रिया object पर flat लौटाई जाती हैं। Instagram हर track के लिए हर फ़ील्ड नहीं लौटाता, इसलिए `audioId` को छोड़कर सभी फ़ील्ड को वैकल्पिक मानें।

<ResponseField name="status" type="string">`success` जब track मिल गया।</ResponseField>
<ResponseField name="audioId" type="string">Track id, वापस echo की गई।</ResponseField>
<ResponseField name="title" type="string">Track का शीर्षक।</ResponseField>
<ResponseField name="displayArtist" type="string">Artist का नाम, जैसा Instagram दिखाता है।</ResponseField>
<ResponseField name="durationMs" type="integer">मिलीसेकंड में track की लंबाई।</ResponseField>
<ResponseField name="thumbnailUrl" type="string">Cover artwork thumbnail URL।</ResponseField>
<ResponseField name="audioType" type="string">या तो `music` या `original_sound`।</ResponseField>

<ResponseField name="isAdsEligible" type="boolean">
  क्या track किसी ad में उपयोग किया जा सकता है।
</ResponseField>

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

  ```json 400: Track unavailable theme={"system"}
  {
    "status": "error",
    "code": 517,
    "action": "post",
    "message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
    "platform": "instagram"
  }
  ```
</ResponseExample>

<Note>
  **उपलब्धता क्षेत्र-निर्भर है।** ऐसी id जो मौजूद नहीं है, ऐसी id जो खाते के क्षेत्र में लाइसेंस-प्राप्त नहीं
  है, और ऐसी id जो इस उपयोग के लिए लाइसेंस-प्राप्त नहीं है — तीनों के लिए Meta एक ही त्रुटि लौटाता है। तीनों
  `517` रिपोर्ट करते हैं, इसलिए जो track एक खाते के लिए resolve होता है वह दूसरे के लिए वैध रूप से विफल हो
  सकता है। यह मानने के बजाय कि stored id अभी भी काम करती है, id को लुकअप करें।
</Note>

## त्रुटियाँ

| Code | अर्थ |
| - | - |
| 156 | Instagram इस profile से लिंक नहीं है। |
| 161 | Instagram का authorization समाप्त हो गया या रद्द कर दिया गया। खाते को रिलिंक करें। |
| 239 | Instagram ने account-स्तरीय कारण से अनुरोध अस्वीकार किया। |
| 258 | Instagram ने malformed प्रतिक्रिया या unmapped विफलता लौटाई। |
| 425 | कनेक्शन में एक आवश्यक Instagram permission गुम है। रिलिंक करें और सभी permissions दें। |
| 435 | Instagram की rate limit तक पहुँच गई। पुनः प्रयास से पहले प्रतीक्षा करें। |
| 514 | Instagram, Instagram Login से लिंक है। Audio API के लिए Facebook Login आवश्यक है। |
| 516 | `audioId` गुम या खाली है। |
| 517 | Instagram id को नहीं पहचानता, या track इस खाते के लिए अनुपलब्ध है। |

Code 514 से 518 का वर्णन [Instagram Reels audio त्रुटियों](/docs/errors/errors-ayrshare#instagram-reels-audio-errors) में किया गया है; बाकी [Ayrshare त्रुटि संदर्भ](/docs/errors/errors-ayrshare) में हैं।

## अगले चरण

<Card title="एक track खोजें" icon="magnifying-glass" href="/docs/apis/media/search-instagram-audio" horizontal />

<Card title="Track को Reel में अटैच करें" icon="music" href="/docs/apis/post/social-networks/instagram#adding-music-to-a-reel" horizontal />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.