> ## 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 オーディオメタデータを取得

> ID を指定して単一の Instagram オーディオ楽曲の詳細を照会する

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

`audioId` を指定して、1 つのオーディオ楽曲の詳細を取得します。保存済みの ID がまだ有効かを確認したり、公開前に楽曲のタイトルとアートワークを表示したりするために使用します。

<InstagramAudioNotice />

## ヘッダーパラメータ

<HeaderAPI />

## パスパラメータ

<ParamField path="audioId" type="string" required>
  [オーディオ検索](/docs/apis/media/search-instagram-audio) が返す楽曲 ID。Instagram が認識しない ID は
  `code: 517` を返します。
</ParamField>

## レスポンスフィールド

楽曲のフィールドは、ネストされるのではなく、レスポンスオブジェクトの直下にフラットに返されます。Instagram はすべての楽曲についてすべてのフィールドを返すとは限らないため、`audioId` 以外のすべてのフィールドはオプションとして扱ってください。

<ResponseField name="status" type="string">楽曲が見つかった場合は `success`。</ResponseField>
<ResponseField name="audioId" type="string">楽曲 ID がそのまま返されます。</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">
  その楽曲を広告で使用できるかどうか。
</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>
  **利用可否は地域に依存します。** Meta は、存在しない ID、アカウントの地域でライセンスされていない ID、
  この用途でライセンスされていない ID に対して同じエラーを返します。3 つのケースはいずれも `517` として
  報告されるため、あるアカウントでは解決できる楽曲が、別のアカウントでは正当に失敗することがあります。
  保存済みの ID がまだ有効であると想定せず、照会して確認してください。
</Note>

## エラー

| Code | 意味                                                                       |
| ---- | ------------------------------------------------------------------------ |
| 156  | Instagram がこのプロファイルに連携されていません。                                           |
| 161  | Instagram の認可が期限切れになったか取り消されました。アカウントを再連携してください。                         |
| 239  | アカウントレベルの理由により Instagram がリクエストを拒否しました。                                  |
| 258  | Instagram が不正な形式のレスポンス、またはマッピングされていない失敗を返しました。                           |
| 425  | 接続に必要な Instagram の権限が不足しています。再連携してすべての権限を付与してください。                       |
| 435  | Instagram のレート制限に達しました。しばらく待ってから再試行してください。                               |
| 514  | Instagram が Instagram Login で連携されています。Audio API には Facebook Login が必要です。 |
| 516  | `audioId` が欠落しているか空です。                                                   |
| 517  | Instagram が ID を認識しないか、このアカウントではその楽曲を利用できません。                            |

コード 514 から 518 については [Instagram Reels オーディオエラー](/docs/errors/errors-ayrshare#instagram-reels-audio-errors) で説明されています。その他については [Ayrshare エラーリファレンス](/docs/errors/errors-ayrshare) を参照してください。

## 次のステップ

<Card title="楽曲を検索する" icon="magnifying-glass" href="/docs/apis/media/search-instagram-audio" horizontal />

<Card title="楽曲を Reel に添付する" icon="music" href="/docs/apis/post/social-networks/instagram#adding-music-to-a-reel" horizontal />