Media Instagram
Updated: 20 Okt 2026
Salinan LLM
Mewakili album, foto, atau video Instagram (video, video siaran langsung, reel, atau cerita yang diunggah).
Jika Anda bermigrasi dari endpoint Iklan Instagram Marketing API ke endpoint Platform Instagram, perhatikan bahwa beberapa nama kolom berbeda.
Memperkenalkan kolom berikut:
legacy_instagram_media_id
Kolom endpoint Iklan Instagram Marketing API berikut tidak didukung:
filter_namelocationlocation_namelatitudelongitude
Membuat
Operasi ini tidak didukung.
Membaca
GET /<IG_MEDIA_ID>Persyaratan
| Instagram API dengan Unified Login | Instagram API dengan Instagram Login | Instagram API dengan Facebook Login | |
|---|---|---|---|
Token Akses |
| ||
URL Penyelenggara | graph.facebook.com | graph.instagram.com | graph.facebook.com |
Jenis Login | Login Facebook untuk Bisnis | Login Bisnis untuk Instagram | Login Facebook untuk Bisnis |
|
|
Jika pengguna aplikasi diberi peran melalui Pengelola Bisnis di Halaman yang terhubung ke akun profesional Instagram pengguna aplikasi Anda, aplikasi Anda juga akan memerlukan salah satu dari:
|
Batasan
- Kolom seperti
comments_countdanlike_counthanya menampilkan interaksi pada media Instagram target dan tidak menyertakan data dari platform lain. Contohnya,comments_countmenampilkan jumlah komentar pada sebuah foto, tetapi tidak menampilkan komentar pada iklan yang berisi foto tersebut. Gunakantotal_comments_countdantotal_like_countuntuk mendapatkan jumlah agregat yang menyertakan interaksi dari media yang ditingkatkan/dipromosikan/iklan. Crossposting jumlah postingan Facebook mungkin disertakan jika postingan tersebut dapat diakses oleh pengguna sesi. - Keterangan tidak menyertakan simbol
@kecuali pengguna aplikasi juga dapat melakukan tugas setara admin pada aplikasi. - Beberapa kolom, seperti
permalink, tidak dapat digunakan pada foto dalam album (turunan). - Media Instagram video siaran langsung hanya dapat dibaca saat sedang disiarkan.
- API ini hanya menampilkan data untuk media yang dimiliki oleh akun profesional Instagram. Ini tidak bisa digunakan untuk mendapatkan data untuk media yang dimiliki oleh akun Instagram pribadi.
- Kolom
reposts_count,saved_count,shares_count,total_like_count,total_comments_count, dantotal_views_counttidak tersedia untuk media turunan carousel dan hanya ditampilkan untuk objek media level atas. Pemilik media dapat menonaktifkan penampilan jumlah suka, komentar, tayangan, posting ulang, dan bagikan. Dalam hal ini, kolom terkait tidak ditampilkan.
Sintaks Permintaan
GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
?fields=<LIST_OF_FIELDS> \
&access_token=<ACCESS_TOKEN>Parameter Jalur
| Placeholder | Nilai |
|---|---|
<API_VERSION>Versi terbaru adalah: v26.0 |
Versi API yang digunakan aplikasi Anda. Jika tidak ditentukan dalam panggilan API Anda, ini akan menjadi versi terbaru pada saat Anda membuat aplikasi Meta atau, jika versi tersebut tidak lagi tersedia, versi yang paling lama tersedia.Pelajari selengkapnya tentang pembuatan versi. |
<HOST_URL> | URL penyelenggara yang digunakan aplikasi Anda untuk meminta endpoint. |
<IG_MEDIA_ID> | Wajib. ID untuk media yang akan diterbitkan. |
Parameter String Kueri
| Kunci | Placeholder | Nilai |
|---|---|---|
access_token | <ACCESS_TOKEN> | Wajib. Token akses Pengguna Facebook atau Instagram pengguna aplikasi. |
fields | <LIST_OF_FIELDS> | Daftar yang dipisahkan koma berisi kolom-kolom yang ingin Anda tampilkan. |
Kolom
Kolom publik dapat dibaca melalui perluasan kolom.
| Kolom | Deskripsi | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
alt_text Publik | Teks deskriptif untuk gambar, untuk aksesibilitas. | ||||||||||||||||
boost_ads_list | Menawarkan gambaran umum tentang semua informasi iklan Instagram yang terkait dengan media organik untuk iklan dengan status ACTIVE. Ini termasuk ID iklan relatif dan status penayangan iklan. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
boost_eligibility_info | Kolom ini menyediakan informasi tentang meningkatkan kelayakan media Instagram sebagai iklan dan detail tambahan jika tidak memenuhi syarat. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
caption Publik | Keterangan. Mengecualikan turunan album. Simbol @ tidak disertakan, kecuali pengguna aplikasi dapat melakukan tugas setara admin di Halaman Facebook yang terhubung ke akun Instagram yang digunakan untuk membuat keterangan. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
comments_count Publik | Jumlah komentar pada media. Mengecualikan komentar pada media turunan album dan keterangan media. Termasuk balasan pada komentar. | ||||||||||||||||
copyright_check_information.status | Menampilkan objek status dan matches_found
Jika video melanggar hak cipta, copyright_matches ditampilkan dengan array objek tentang materi berhak cipta, kapan pelanggaran terjadi dalam video, dan tindakan yang diambil untuk memitigasi pelanggaran.
| ||||||||||||||||
id Publik | ID Media. | ||||||||||||||||
is_ai_generated | Menunjukkan apakah media memiliki label AI. Mengecualikan turunan album. | ||||||||||||||||
is_comment_enabled | Menandai apakah komentar diaktifkan atau dinonaktifkan. Mengecualikan turunan album. | ||||||||||||||||
is_shared_to_feed Publik | Hanya untuk Reels. Jika true, menunjukkan reel dapat muncul baik di tab Kabar maupun Reels. Jika false, menunjukkan reel hanya dapat muncul di tab Reels.Tidak ada nilai yang menentukan apakah reel benar-benar muncul di tab Reels karena reel mungkin tidak memenuhi persyaratan kelayakan atau mungkin tidak dipilih oleh algoritma kami. Lihat spesifikasi reel untuk kriteria kelayakan. | ||||||||||||||||
legacy_instagram_media_id | ID untuk media Instagram yang dibuat untuk endpoint Marketing API untuk v21.0 dan yang lebih lama. | ||||||||||||||||
like_count | Jumlah suka pada media, termasuk balasan pada komentar. Mengecualikan suka pada media turunan album dan suka pada postingan promosi yang dibuat dari media.
Jika dikueri secara tidak langsung melalui endpoint atau perluasan kolom lain, kolom like_count akan dihilangkan jika pemilik media memiliki jumlah suka tersembunyi. | ||||||||||||||||
media_audio_type Publik | Jenis audio yang digunakan dalam media. Dapat berupa MUSIC atau ORIGINAL_SOUND. Ditampilkan hanya untuk media video seperti Reels; tidak ditampilkan untuk jenis media lain (misalnya, foto dan carousel). | ||||||||||||||||
media_product_type Publik | Permukaan tempat media diterbitkan. Dapat berupa AD, FEED, STORY, atau REELS. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
media_type Publik | Jenis media. Dapat berupa CAROUSEL_ALBUM, IMAGE, atau VIDEO. | ||||||||||||||||
media_url Publik | URL untuk media. Kolom media_url dihilangkan dari tanggapan dalam salah satu kasus berikut:
Semua kolom lain pada objek media ditampilkan seperti normal. Media gambar dan kontainer carousel tidak terpengaruh, meskipun turunan video carousel dapat terpengaruh. Perlakukan media_url sebagai kolom opsional di aplikasi Anda dan kembali ke permalink atau thumbnail_url jika tidak ada. | ||||||||||||||||
owner Publik | ID pengguna Instagram yang membuat media. Hanya ditampilkan jika pengguna aplikasi yang membuat kueri juga membuat media, jika tidak, kolom username akan ditampilkan. | ||||||||||||||||
permalink Publik | URL Permanen untuk media. | ||||||||||||||||
shortcode Publik | Kode singkat untuk media. | ||||||||||||||||
thumbnail_url Publik | URL gambar mini media. Hanya tersedia di media VIDEO. | ||||||||||||||||
timestamp Publik | Tanggal pembuatan berformat ISO 8601 di UTC (default-nya adalah UTC ±00:00). | ||||||||||||||||
username Publik | Nama pengguna yang membuat media. | ||||||||||||||||
view_count Publik | Jumlah tayangan untuk Instagram Reels, yang mencakup metrik berbayar dan organik. Untuk konten yang di-crossposting ke Facebook, ini menampilkan gabungan jumlah tayangan Instagram dan Facebook jika postingan Facebook dapat diakses oleh pengguna sesi. Tersedia untuk Business Discovery API saja. | ||||||||||||||||
reposts_count Publik | Jumlah berapa kali media telah diposting ulang. Tersedia untuk media KABAR dan REEL. Tidak dapat diakses melalui endpoint API tagar. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
saved_count | Jumlah berapa kali media telah disimpan. Tersedia untuk media KABAR dan REEL. Hanya dapat diakses oleh pemilik media atau kolaborator yang diterima. Tidak dapat diakses melalui Penemuan Bisnis, media yang ditandai/disebutkan, atau endpoint API tagar. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
shares_count | Jumlah berapa kali media telah dibagikan. Tersedia untuk media KABAR dan REELS. Tidak dapat diakses melalui Penemuan Bisnis atau endpoint API tagar. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
total_comments_count Publik | Jumlah total komentar pada media di semua platform, termasuk komentar pada media yang ditingkatkan/dipromosikan terkait. Tidak dapat diakses melalui endpoint API tagar. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
total_like_count Publik | Jumlah total suka pada media di semua platform, termasuk suka pada media yang ditingkatkan/dipromosikan terkait. Tidak dapat diakses melalui endpoint API tagar. Hanya tersedia untuk Instagram API dengan Facebook Login. | ||||||||||||||||
total_views_count | Jumlah total tayangan konten video di semua platform, termasuk tayangan dari media yang ditingkatkan/dipromosikan dan pemutaran ulang. Hanya tersedia untuk media video. Tidak dapat diakses melalui Penemuan Bisnis atau endpoint API tagar. Untuk Penemuan Business, gunakan view_count sebagai gantinya. Hanya tersedia untuk Instagram API dengan Facebook Login. |
Edge
Edge publik dapat ditampilkan melalui perluasan kolom.
| Edge | Deskripsi |
|---|---|
children Publik. | Mewakili koleksi objek Media Instagram pada album Media Instagram. |
Mewakili daftar pengguna yang ditambahkan sebagai kolaborator di objek Media Instagram. Hanya tersedia untuk Instagram API dengan Facebook Login. | |
Mewakili koleksi Komentar Instagram pada objek Media Instagram. | |
Mewakili komentar dalam urutan tampilan Instagram, yang dapat mencakup komentar dari semua media Instagram iklan. Tersedia untuk Instagram API dengan Login Facebook saja. | |
Mewakili metrik interaksi sosial di objek Media Instagram. |
Contoh cURL
Contoh permintaan
curl -X GET \
'https://graph.instagram.com/v26.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'
Contoh tanggapan
{ "id": "17918920912340654", "media_type": "IMAGE", "media_url": "https://sconten...", "owner": { "id": "17841405309211844" }, "timestamp": "2019-09-26T22:36:43+0000" }
Memperbarui
POST /<IG_MEDIA_ID>Aktifkan atau nonaktifkan komentar di Media Instagram.
Persyaratan
| Instagram API dengan Unified Login | Instagram API dengan Instagram Login | Instagram API dengan Facebook Login | |
|---|---|---|---|
Token Akses |
| ||
URL Penyelenggara | graph.facebook.com | graph.instagram.com | graph.facebook.com |
Jenis Login | Login Facebook untuk Bisnis | Login Bisnis untuk Instagram | Login Facebook untuk Bisnis |
|
|
Jika pengguna aplikasi diberi peran melalui Pengelola Bisnis di Halaman yang terhubung ke Pengguna Instagram target, Anda juga memerlukan salah satu dari:
|
Batasan
Video siaran langsung Media Instagram tidak didukung.
Sintaks Permintaan
POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
?comment_enabled=<BOOL>
&access_token=<ACCESS_TOKEN>Parameter Jalur
| Placeholder | Nilai |
|---|---|
<API_VERSION>Versi terbaru adalah: v26.0 |
Versi API yang digunakan aplikasi Anda. Jika tidak ditentukan dalam panggilan API Anda, ini akan menjadi versi terbaru pada saat Anda membuat aplikasi Meta atau, jika versi tersebut tidak lagi tersedia, versi yang paling lama tersedia.Pelajari selengkapnya tentang pembuatan versi. |
<HOST_URL> | URL penyelenggara yang digunakan aplikasi Anda untuk meminta endpoint. |
<IG_MEDIA_ID> | Wajib. ID untuk media yang akan diterbitkan. |
Parameter String Kueri
| Kunci | Placeholder | Nilai |
|---|---|---|
access_token | <ACCESS_TOKEN> | Wajib.Token akses pengguna aplikasi. |
comment_enabled | <BOOL> | Wajib. Atur ke true untuk mengaktifkan komentar atau false untuk menonaktifkan komentar. |
Contoh cURL
Contoh permintaan
curl -i -X POST \
"https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."
Contoh tanggapan
{ "success": true }
Menghapus
DELETE /<IG_MEDIA_ID>Hapus Media Instagram.
Persyaratan
| Instagram API dengan Facebook Login | |
|---|---|
Token Akses | |
URL Penyelenggara | graph.facebook.com |
Jenis Login | Login Facebook untuk Bisnis |
|
Batasan
API ini hanya mendukung Instagram API yang menggunakan login Facebook saja. Postingan non-iklan, Cerita, Reels, dan seluruh album carousel didukung. Untuk menghapus media di dalam album carousel, seluruh album carousel harus dihapus dengan menentukan id media kontainer carousel. Menghapus media di dalam carousel satu per satu tidak didukung.
Sintaks Permintaan
POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
?access_token=<ACCESS_TOKEN>Parameter Jalur
| Placeholder | Nilai |
|---|---|
<API_VERSION>Versi terbaru adalah: v26.0 |
Versi API yang digunakan aplikasi Anda. Jika tidak ditentukan dalam panggilan API Anda, ini akan menjadi versi terbaru pada saat Anda membuat aplikasi Meta atau, jika versi tersebut tidak lagi tersedia, versi yang paling lama tersedia.Pelajari selengkapnya tentang pembuatan versi. |
<IG_MEDIA_ID> | Wajib. ID untuk media yang akan diterbitkan. |
Parameter String Kueri
| Kunci | Placeholder | Nilai |
|---|---|---|
access_token | <ACCESS_TOKEN> | Wajib.Token akses pengguna aplikasi. |
Contoh cURL
Contoh permintaan
curl -i -X DELETE \
"https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."
Contoh tanggapan (Berhasil)
{ "success": true, "deleted_id": "17918920912340654" }
Contoh tanggapan (Gagal, Jenis Media Tidak Didukung)
{ "error": { "message": "Fatal", "type": "OAuthException", "code": -1, "error_subcode": 2207073, "is_transient": false, "error_user_title": "Media Type Not Supported", "error_user_msg": "The media type is not supported for this endpoint", "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw" }, }