Pewarta Proxy

📋 Server Request & Proxy Logs

Loading active proxy settings...
Developed by Khairul Adha (adhexa.id)
Mengambil log server...

⚙️ Pengaturan Proxy Target

Platform Instagram

Instagram Audio API

Updated: 16 Jun 2026
Instagram Audio API memungkinkan Anda mengambil dan mencari audio — baik suara asli dari Instagram Reels dan musik — dan melampirkannya ke Reels pada saat dibuat. API ini tersedia dengan Instagram API dengan Facebook Login dan Instagram API dengan Unified Login.

Sebelum Memulai

Anda memerlukan berikut ini:
  • Akun Instagram Business atau Akun Kreator Instagram
  • Halaman Facebook yang terhubung ke akun tersebut
  • Aplikasi Facebook terdaftar dengan izin berikut yang diberikan melalui Facebook Login:
    • instagram_basic
    • instagram_content_publish
  • Token akses Pengguna yang valid

Batasan

  • Ketersediaan musik: API ini mengembalikan audio yang telah diotorisasi untuk penggunaan pihak ketiga. Perhatikan bahwa pilihan yang tersedia dapat bervariasi dari apa yang muncul di aplikasi native.
  • Dukungan platform: API ini tersedia di Instagram API dengan Facebook Login dan Instagram API dengan Unified Login. Ini tidak didukung di Instagram API dengan Instagram Login.
  • Pratinjau reel: Melihat pratinjau Reel dengan audio terlampir tidak didukung. Reel akan diterbitkan seperti yang dikonfigurasi.
  • Batasan filter: Saat mengambil audio, jika tidak ada kueri pencarian yang disediakan, audio yang sedang tren akan ditampilkan.

Endpoint

Cari aset audio

Mencari aset audio untuk digunakan di Reels. Anda dapat mencari suara asli dari Reels atau musik yang ada. Jika kueri pencarian dihilangkan, suara atau musik asli yang sedang tren akan ditampilkan secara default.

Sintaks permintaan

GET /ig_audio?audio_type={audio-type}&user_id={user-id}&access_token={access-token}

Parameter string kueri

Parameter Jenis Deskripsi
audio_type
Enum
Wajib. Jenis audio yang akan dicari. Nilai: original_sound, music.
user_id
String
Wajib. ID Pengguna Instagram yang melakukan kueri.
search_query
String
Opsional. String pencarian untuk memfilter hasil berdasarkan kata kunci.
access_token
String
Wajib. Token akses Pengguna yang valid.

Contoh permintaan

curl -X GET "https://graph.facebook.com/v22.0/ig_audio?audio_type=music&user_id={user-id}&access_token={access-token}"

Contoh tanggapan

{
  "audio": [
    {
      "audio_id": "587784541076604",
      "cover_artwork_thumbnail_uri": "https://scontent-...",
      "display_artist": "Shuba",
      "duration_in_ms": 153760,
      "audio_type": "music",
      "title": "Birthday Wish",
      "download_url": "https://scontent-lga3..."
    },
    {
      "audio_id": "587784541076614",
      "display_artist": "Drake",
      "duration_in_ms": 153760,
      "audio_type": "music",
      "title": "Birthday Wish",
      "on_platform_audio_preview_link": "https://www.instagram.com...",
      "is_ads_eligible": false
    }
  ]
}

Kolom tanggapan

Kolom Jenis Deskripsi
audio_id
String
Pengidentifikasi unik untuk aset audio.
cover_artwork_thumbnail_uri
String
URL gambar mini karya seni sampul. Dikembalikan hanya untuk jenis musik. Mungkin null saat tidak ada URL yang tersedia.
display_artist
String
Nama tampilan artis. Dikembalikan hanya untuk jenis musik.
duration_in_ms
Bilangan bulat
Durasi aset audio dalam milidetik.
audio_type
Bilangan bulat
Jenis aset audio.
title
String
Judul aset audio.
download_url
String
URL sementara untuk mendengarkan cuplikan file audio. URL ini kedaluwarsa setelah sekitar 1,5 hari. Mungkin null saat tidak ada URL pratinjau yang tersedia.
ig_username
String
Nama pengguna Instagram kreator. Dikembalikan hanya untuk jenis original_sound.
profile_picture_url
String
URL foto profil kreator. Dikembalikan hanya untuk jenis original_sound.
is_ads_eligible
Boolean
Boolean yang dapat dinolkan yang menunjukkan apakah aset audio dapat digunakan dalam iklan.
on_platform_audio_preview_link
String
URL untuk pratinjau audio. Mungkin nihil jika tidak tersedia.

Dapatkan metadata audio

Mengambil metadata untuk aset audio tertentu berdasarkan ID-nya.

Sintaks permintaan

GET /{ig-audio-id}?user_id={user-id}&access_token={access-token}

Parameter jalur

Parameter Jenis Deskripsi
{ig-audio-id}
String
Wajib. Pengidentifikasi unik (FBID) aset audio.

Parameter string kueri

Parameter Jenis Deskripsi
user_id
String
Wajib. ID Pengguna Instagram yang melakukan kueri.
access_token
String
Wajib. Token akses Pengguna yang valid.

Contoh permintaan

curl -X GET "https://graph.facebook.com/v22.0/587784541076604?user_id={user-id}&access_token={access-token}"

Contoh tanggapan

{
  "audio_id": "587784541076604",
  "cover_artwork_thumbnail_url": "https://scontent-lga3-...",
  "display_artist": "Shuba",
  "duration_in_ms": 153760,
  "audio_type": "music",
  "title": "Birthday Wish",
  "download_url": "https://scontent-lga3..."
}

Kolom tanggapan

Kolom Jenis Deskripsi
audio_id
String
Pengidentifikasi unik untuk aset audio.
cover_artwork_thumbnail_url
String
URL gambar mini karya seni sampul. Dikembalikan hanya untuk jenis musik. Mungkin null saat tidak ada URL yang tersedia.
display_artist
String
Nama tampilan artis. Dikembalikan hanya untuk jenis musik.
duration_in_ms
Bilangan bulat
Durasi trek audio dalam milidetik.
audio_type
String
Jenis audio: music atau original_sound.
title
String
Judul trek audio.
download_url
String
URL sementara untuk mendengarkan cuplikan file audio. URL ini kedaluwarsa setelah sekitar 1,5 hari. Mungkin null saat tidak ada URL pratinjau yang tersedia.
ig_username
String
Nama pengguna Instagram dari kreator audio asli. Dikembalikan hanya untuk jenis original_sound.
profile_picture_url
String
URL foto profil kreator. Dikembalikan hanya untuk jenis original_sound.
is_ads_eligible
Boolean
Boolean yang dapat dinolkan yang menunjukkan apakah aset audio dapat digunakan dalam iklan.
on_platform_audio_preview_link
String
URL untuk pratinjau audio. Mungkin nihil jika tidak tersedia.

Temukan audio pengganti untuk iklan

Temukan trek Koleksi Audio bebas royalti untuk mengganti musik berhak cipta dalam Instagram Reels sebelum mempromosikannya sebagai iklan. Ini menggunakan endpoint /ig_audio yang sama dengan product=ADS.
Melakukan pertukaran: Endpoint ini hanya menemukan audio pengganti. Untuk menerapkan trek yang ditemukan ke iklan Instagram Reels, lihat Pertukaran Audio Instagram untuk Iklan Instagram Reels.
Izin yang diperlukan:ads_management.
Ketersediaan: Fitur ini dalam rilis terbatas. Permintaan dari aplikasi tanpa akses akan menampilkan kesalahan izin level 200.

Sintaks permintaan

GET /ig_audio?product=ADS&purpose=AUDIO_COPYRIGHT_REPLACEMENT&audio_replacement_mode={mode}&ig_media_id={ig-media-id}&access_token={access-token}
Catatan:ig_media_id diperlukan untuk setiap mode dan harus merujuk pada Reel yang berisi musik berhak cipta. Foto, carousel, dan Reels tanpa masalah hak cipta akan ditolak.

Parameter string kueri

Parameter Jenis Deskripsi
product
Enum
Wajib. Atur ke ADS untuk menggunakan fitur audio iklan.
purpose
Enum
Wajib. Atur ke AUDIO_COPYRIGHT_REPLACEMENT, saat ini satu-satunya subcontoh penggunaan yang didukung untuk product=ADS.
audio_replacement_mode
Enum
Wajib. Cara audio ditemukan. default menampilkan daftar Koleksi Audio yang diurutkan berdasarkan popularitas yang ditampilkan di Pengelola Iklan Meta. search melakukan pencarian teks di seluruh Koleksi Audio (memerlukan search_query). auto menampilkan trek dengan kecocokan terbaik yang direkomendasikan untuk Reel yang dirujuk oleh ig_media_id.
ig_media_id
String
Wajib untuk semua mode. FBID (dari /me/media) Reel Instagram yang berisi musik berhak cipta yang akan diganti. Media harus berupa Reel dengan masalah hak cipta yang terdeteksi. Dalam mode auto itu mendorong rekomendasi; dalam mode search dan default itu memerlukan konteks tetapi tidak memengaruhi peringkat.
search_query
String
Diperlukan saat audio_replacement_mode=search; tidak diizinkan dalam mode auto atau default. String kata kunci yang cocok dengan judul lagu, artis, dan indeks pencarian.
ig_user_id
String
Wajib untuk media iklan kemitraan. Juga diperlukan untuk token agensi atau multiakun. Opsional jika tidak untuk product=ADS — pemberian ads_management mengotorisasi panggilan dan akun Instagram berasal dari token akses.
partnership_ad_code
String
Opsional. Untuk iklan kemitraan, kode iklan yang mengizinkan akses ke media kreator. Harus sesuai dengan media yang sama dengan ig_media_id.
access_token
String
Wajib. Token akses Pengguna yang valid dengan ads_management.
Hasilnya dikembalikan dalam halaman. default mengembalikan hingga 30 trek, search hingga 25 per halaman, dan auto mengembalikan satu trek.

Contoh permintaan

curl -X GET "https://graph.facebook.com/v22.0/ig_audio?product=ADS&purpose=AUDIO_COPYRIGHT_REPLACEMENT&audio_replacement_mode=default&ig_media_id={ig-media-id}&access_token={access-token}"

Contoh tanggapan

{
  "audio": [
    {
      "audio_id": "587784541076604",
      "cover_artwork_thumbnail_uri": "https://scontent-...",
      "display_artist": "Shuba",
      "duration_in_ms": 153760,
      "title": "Birthday Wish",
      "download_url": "https://scontent-lga3..."
    }
  ]
}

Kolom tanggapan

Tanggapan iklan hanya menampilkan musik bebas royalti dan menyertakan kolom berikut:
Kolom Jenis Deskripsi
audio_id
String
Pengidentifikasi unik untuk aset audio. Gunakan nilai ini sebagai audio_id di audio_configuration saat menerbitkan Reel.
cover_artwork_thumbnail_uri
String
URL gambar mini karya seni sampul.
display_artist
String
Nama tampilan artis.
duration_in_ms
Bilangan bulat
Durasi trek dalam milidetik.
title
String
Judul trek.
download_url
String
URL sementara untuk mendengarkan cuplikan file audio. Mungkin kosong jika tidak ada URL pratinjau yang tersedia.

Kesalahan

Lihat referensi Kode Kesalahan untuk tanggapan kesalahan.

Menerbitkan Reel dengan audio

Lampirkan aset audio ke Reel selama pembuatan konten. Ini menggunakan alur Penerbitan Konten yang ada dengan parameter audio_configuration tambahan.

Langkah 1: Buat kontainer media

Sintaks permintaan

POST /{ig-user-id}/media
Sertakan objek audio_configuration baru bersama parameter Reel Anda yang sudah ada (video_url, media_type=REELS, dsb.).
Catatan: Parameter baru: audio_configuration
Kolom Jenis Deskripsi
audio_id
String
Wajib. Pengidentifikasi unik dari aset audio yang akan dilampirkan, diperoleh dari endpoint Cari Audio atau Dapatkan Metadata Audio.
audio_volume
Bilangan bulat
Opsional. Level volume untuk aset audio, dari 1 hingga 100 (volume penuh). Default-nya adalah 100.
video_volume
Bilangan bulat
Opsional. Level volume untuk audio asli video, dari 1 hingga 100 (volume penuh). Default-nya adalah 100.

Contoh permintaan

curl -X POST "https://graph.facebook.com/v22.0/{ig-user-id}/media" \
  -d "media_type=REELS" \
  -d "video_url={video-url}" \
  -d 'audio_configuration={"audio_id":"587784541076604","audio_volume":80,"video_volume":50}' \
  -d "access_token={access-token}"

Langkah 2: Terbitkan kontainer media

Setelah kontainer dibuat, terbitkan menggunakan endpoint penerbitan standar:
POST /{ig-user-id}/media_publish?creation_id={creation-id}access_token={access-token}
Lihat dokumentasi Penerbitan Konten untuk detail lengkap tentang alur penerbitan dua langkah.
Contoh alur kerja
Berikut adalah contoh lengkap yang menunjukkan cara mencari musik yang sedang tren dan melampirkannya ke Reel:
  1. Mencari musik yang sedang tren:
curl -X GET "https://graph.facebook.com/v22.0/ig_audio?audio_type=musicuser_id={user-id}access_token={access-token}"
  1. (Opsional) Dapatkan metadata untuk aset audio tertentu:
curl -X GET "https://graph.facebook.com/v22.0/{audio-id}?user_id={user-id}access_token={access-token}"
  1. Buat kontainer Reel dengan audio terlampir:
curl -X POST "https://graph.facebook.com/v22.0/{ig-user-id}/media" \
  -d "media_type=REELS" \
  -d "video_url={video-url}" \
  -d 'audio_configuration={"audio_id":"{audio-id}","audio_volume":100,"video_volume":60}' \
  -d "access_token={access-token}"
  1. Terbitkan Reel:
curl -X POST "https://graph.facebook.com/v22.0/{ig-user-id}/media_publish?creation_id={creation-id}access_token={access-token}"