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

# Obtenir les métadonnées audio Instagram

> Consultez les détails d'une seule piste audio Instagram à partir de son identifiant

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

Récupérez les détails d'une piste audio à partir de son `audioId`. Utilisez cet endpoint pour confirmer qu'un identifiant stocké est toujours valide, ou pour afficher le titre et la pochette d'une piste avant de publier.

<InstagramAudioNotice />

## Paramètres d'en-tête

<HeaderAPI />

## Paramètres de chemin

<ParamField path="audioId" type="string" required>
  L'identifiant de la piste, tel que renvoyé par la [recherche audio](/docs/apis/media/search-instagram-audio).
  Un identifiant qu'Instagram ne reconnaît pas renvoie `code: 517`.
</ParamField>

## Champs de réponse

Les champs de la piste sont renvoyés à plat sur l'objet de réponse plutôt qu'imbriqués. Instagram ne renvoie pas tous les champs pour chaque piste ; considérez donc tous les champs, à l'exception d'`audioId`, comme facultatifs.

<ResponseField name="status" type="string">`success` lorsque la piste a été trouvée.</ResponseField>
<ResponseField name="audioId" type="string">L'identifiant de la piste, renvoyé en écho.</ResponseField>
<ResponseField name="title" type="string">Titre de la piste.</ResponseField>
<ResponseField name="displayArtist" type="string">Nom de l'artiste tel qu'Instagram l'affiche.</ResponseField>
<ResponseField name="durationMs" type="integer">Durée de la piste en millisecondes.</ResponseField>
<ResponseField name="thumbnailUrl" type="string">URL de la miniature de la pochette.</ResponseField>
<ResponseField name="audioType" type="string">Soit `music`, soit `original_sound`.</ResponseField>

<ResponseField name="isAdsEligible" type="boolean">
  Indique si la piste peut être utilisée dans une publicité.
</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>
  **La disponibilité dépend de la région.** Meta renvoie la même erreur pour un identifiant qui
  n'existe pas, pour un identifiant non licencié dans la région du compte, et pour un identifiant
  non licencié pour cet usage. Les trois cas renvoient `517` ; une piste qui se résout pour un compte
  peut donc légitimement échouer pour un autre. Consultez un identifiant plutôt que de supposer
  qu'un identifiant stocké fonctionne toujours.
</Note>

## Erreurs

| Code | Signification                                                                                                                 |
| ---- | ----------------------------------------------------------------------------------------------------------------------------- |
| 156  | Instagram n'est pas connecté à ce profil.                                                                                     |
| 161  | L'autorisation Instagram a expiré ou a été révoquée. Reconnectez le compte.                                                   |
| 239  | Instagram a rejeté la requête pour une raison liée au compte.                                                                 |
| 258  | Instagram a renvoyé une réponse malformée ou un échec non mappé.                                                              |
| 425  | La connexion ne dispose pas d'une autorisation Instagram requise. Reconnectez le compte et accordez toutes les autorisations. |
| 435  | La limite de débit d'Instagram a été atteinte. Attendez avant de réessayer.                                                   |
| 514  | Instagram est connecté avec Instagram Login. L'API Audio nécessite Facebook Login.                                            |
| 516  | L'`audioId` est manquant ou vide.                                                                                             |
| 517  | Instagram ne reconnaît pas l'identifiant, ou la piste est indisponible pour ce compte.                                        |

Les codes 514 à 518 sont décrits dans [Erreurs audio des Reels Instagram](/docs/errors/errors-ayrshare#instagram-reels-audio-errors) ; les autres figurent dans la [référence des erreurs Ayrshare](/docs/errors/errors-ayrshare).

## Étapes suivantes

<Card title="Rechercher une piste" icon="magnifying-glass" href="/docs/apis/media/search-instagram-audio" horizontal />

<Card title="Joindre la piste à un Reel" icon="music" href="/docs/apis/post/social-networks/instagram#adding-music-to-a-reel" horizontal />