> ## 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-Metadaten abrufen

> Die Details eines einzelnen Instagram-Audiotracks anhand seiner ID nachschlagen

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

Rufen Sie die Details eines einzelnen Audiotracks anhand seiner `audioId` ab. Verwenden Sie dies, um zu bestätigen, dass eine gespeicherte ID noch gültig ist, oder um Titel und Artwork eines Tracks vor dem Veröffentlichen anzuzeigen.

<InstagramAudioNotice />

## Header-Parameter

<HeaderAPI />

## Pfadparameter

<ParamField path="audioId" type="string" required>
  Die Track-ID, wie sie von der [Audio-Suche](/docs/apis/media/search-instagram-audio) zurückgegeben wird. Eine ID, die Instagram
  nicht erkennt, gibt `code: 517` zurück.
</ParamField>

## Antwortfelder

Die Felder des Tracks werden flach auf dem Antwortobjekt zurückgegeben und nicht verschachtelt. Instagram gibt nicht für jeden Track jedes Feld zurück; behandeln Sie daher alle Felder außer `audioId` als optional.

<ResponseField name="status" type="string">`success`, wenn der Track gefunden wurde.</ResponseField>
<ResponseField name="audioId" type="string">Die Track-ID, als Echo zurückgegeben.</ResponseField>
<ResponseField name="title" type="string">Track-Titel.</ResponseField>
<ResponseField name="displayArtist" type="string">Künstlername, wie Instagram ihn anzeigt.</ResponseField>
<ResponseField name="durationMs" type="integer">Track-Länge in Millisekunden.</ResponseField>
<ResponseField name="thumbnailUrl" type="string">Thumbnail-URL des Cover-Artworks.</ResponseField>
<ResponseField name="audioType" type="string">Entweder `music` oder `original_sound`.</ResponseField>

<ResponseField name="isAdsEligible" type="boolean">
  Ob der Track in einer Anzeige verwendet werden darf.
</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>
  **Die Verfügbarkeit ist regionsabhängig.** Meta gibt denselben Fehler für eine ID zurück, die nicht existiert,
  eine, die in der Region des Kontos nicht lizenziert ist, und eine, die nicht für diese Nutzung lizenziert ist. Alle
  drei melden `517`, sodass ein Track, der für ein Konto aufgelöst wird, für ein anderes berechtigterweise fehlschlagen kann.
  Schlagen Sie eine ID nach, statt anzunehmen, dass eine gespeicherte noch funktioniert.
</Note>

## Fehler

| Code | Bedeutung                                                                                                                   |
| ---- | --------------------------------------------------------------------------------------------------------------------------- |
| 156  | Instagram ist nicht mit diesem Profil verknüpft.                                                                            |
| 161  | Instagrams Autorisierung ist abgelaufen oder wurde widerrufen. Verknüpfen Sie das Konto erneut.                             |
| 239  | Instagram hat die Anfrage aus einem kontobezogenen Grund abgelehnt.                                                         |
| 258  | Instagram hat eine fehlerhafte Antwort oder einen nicht zugeordneten Fehler zurückgegeben.                                  |
| 425  | Der Verbindung fehlt eine erforderliche Instagram-Berechtigung. Verknüpfen Sie erneut und erteilen Sie alle Berechtigungen. |
| 435  | Instagrams Ratenlimit wurde erreicht. Warten Sie vor dem erneuten Versuch.                                                  |
| 514  | Instagram ist mit Instagram Login verknüpft. Die Audio API erfordert Facebook Login.                                        |
| 516  | Die `audioId` fehlt oder ist leer.                                                                                          |
| 517  | Instagram erkennt die ID nicht, oder der Track ist für dieses Konto nicht verfügbar.                                        |

Die Codes 514 bis 518 sind unter [Instagram-Reels-Audio-Fehler](/docs/errors/errors-ayrshare#instagram-reels-audio-errors) beschrieben; die übrigen finden Sie in der [Ayrshare-Fehlerreferenz](/docs/errors/errors-ayrshare).

## Nächste Schritte

<Card title="Nach einem Track suchen" icon="magnifying-glass" href="/docs/apis/media/search-instagram-audio" horizontal />

<Card title="Den Track an einen Reel anhängen" icon="music" href="/docs/apis/post/social-networks/instagram#adding-music-to-a-reel" horizontal />