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

# Lấy metadata audio Instagram

> Tra cứu chi tiết của một bản nhạc audio Instagram theo id của nó

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

Truy xuất chi tiết của một bản nhạc audio theo `audioId` của nó. Sử dụng endpoint này để xác nhận một id đã lưu vẫn còn hợp lệ, hoặc để hiển thị tiêu đề và ảnh bìa của một bản nhạc trước khi xuất bản.

<InstagramAudioNotice />

## Tham số Header

<HeaderAPI />

## Tham số Path

<ParamField path="audioId" type="string" required>
  Id của bản nhạc, như được trả về bởi [tìm kiếm audio](/docs/apis/media/search-instagram-audio). Một id
  Instagram không nhận diện trả về `code: 517`.
</ParamField>

## Trường Phản hồi

Các trường của bản nhạc được trả về phẳng trên đối tượng phản hồi thay vì lồng nhau. Instagram không trả về mọi trường cho mọi bản nhạc, vì vậy hãy coi tất cả các trường ngoại trừ `audioId` là tùy chọn.

<ResponseField name="status" type="string">`success` khi bản nhạc được tìm thấy.</ResponseField>
<ResponseField name="audioId" type="string">Id của bản nhạc, được trả lại nguyên trạng.</ResponseField>
<ResponseField name="title" type="string">Tiêu đề bản nhạc.</ResponseField>
<ResponseField name="displayArtist" type="string">Tên nghệ sĩ như Instagram hiển thị.</ResponseField>
<ResponseField name="durationMs" type="integer">Độ dài bản nhạc tính bằng mili giây.</ResponseField>
<ResponseField name="thumbnailUrl" type="string">URL thumbnail của ảnh bìa.</ResponseField>
<ResponseField name="audioType" type="string">Hoặc `music` hoặc `original_sound`.</ResponseField>

<ResponseField name="isAdsEligible" type="boolean">
  Liệu bản nhạc có thể được sử dụng trong quảng cáo hay không.
</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>
  **Tính khả dụng phụ thuộc vào khu vực.** Meta trả về cùng một lỗi cho một id không tồn tại, một id
  không được cấp phép trong khu vực của tài khoản, và một id không được cấp phép cho mục đích sử dụng
  này. Cả ba đều báo `517`, nên một bản nhạc dùng được với tài khoản này có thể thất bại một cách
  hợp lệ với tài khoản khác. Hãy tra cứu một id thay vì mặc định rằng một id đã lưu vẫn hoạt động.
</Note>

## Lỗi

| Mã | Ý nghĩa |
| - | - |
| 156 | Instagram chưa được liên kết với profile này. |
| 161 | Ủy quyền của Instagram đã hết hạn hoặc bị thu hồi. Liên kết lại tài khoản. |
| 239 | Instagram đã từ chối yêu cầu vì một lý do ở cấp tài khoản. |
| 258 | Instagram trả về một phản hồi bị lỗi định dạng hoặc một thất bại chưa được ánh xạ. |
| 425 | Kết nối thiếu một quyền Instagram bắt buộc. Liên kết lại và cấp tất cả các quyền. |
| 435 | Đã đạt tới giới hạn tốc độ của Instagram. Chờ trước khi thử lại. |
| 514 | Instagram được liên kết bằng Instagram Login. Audio API yêu cầu Facebook Login. |
| 516 | `audioId` bị thiếu hoặc rỗng. |
| 517 | Instagram không nhận diện id, hoặc bản nhạc không khả dụng với tài khoản này. |

Các mã 514 đến 518 được mô tả trong [Lỗi audio Instagram Reels](/docs/errors/errors-ayrshare#instagram-reels-audio-errors); các mã còn lại nằm trong [tài liệu tham khảo lỗi Ayrshare](/docs/errors/errors-ayrshare).

## Các bước tiếp theo

<Card title="Tìm kiếm một bản nhạc" icon="magnifying-glass" href="/docs/apis/media/search-instagram-audio" horizontal />

<Card title="Đính kèm bản nhạc vào một 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.