Insight Media Instagram
Updated: 11 Sep 2026
Salinan LLM
Mewakili metrik interaksi sosial di objek Media Instagram pengguna aplikasi Anda.
Membuat
Operasi ini tidak didukung.
Membaca
GET /<INSTAGRAM_MEDIA_ID>/insightsDapatkan data insight tentang objek Media Instagram.
Batasan
- Jika data insight yang Anda minta tidak ada atau saat ini tidak tersedia, API akan menampilkan set data kosong, bukan
0untuk metrik individu. - Data yang digunakan untuk menghitung metrik dapat tertunda hingga 48 jam.
- Data metrik disimpan hingga 2 tahun.
- Metrik seperti
comments,likes,views, dantotal_interactionshanya melaporkan metrik interaksi organik; interaksi pada iklan yang berisi objek media tidak dihitung. Metriktotal_likes,total_comments, dantotal_viewsmenampilkan jumlah agregat yang menyertakan interaksi dari media yang ditingkatkan/dipromosikan/iklan. Total metrik ini tersedia untuk Instagram API dengan Login Facebook saja. Crossposting jumlah postingan Facebook mungkin disertakan jika postingan tersebut dapat diakses oleh pengguna sesi.
Metrik album
- Data insight tidak tersedia untuk media apa pun dalam album Media Instagram.
Metrik media cerita
- Metrik media cerita hanya tersedia selama 24 jam.
- Siapkan
Instagramwebhooks dan berlangganan ke kolomstory_insightsagar mendapatkan insight cerita untuk suatu cerita sebelum kedaluwarsa. Anda mungkin menerima data setelah cerita kedaluwarsa jika cerita ditambahkan ke sorotan. Hal ini mungkin menampilkan hasil yang berbeda untuk panggilan API, notifikasi webhook, dan UI.
- Siapkan
- Metrik media cerita dengan nilai kurang dari 5 akan menampilkan kode kesalahan
10dengan pesan(#10) Not enough viewers for the media to show insights. - Untuk Cerita yang dibuat oleh pengguna di Eropa dan Jepang, metrik
repliessekarang menampilkan nilai0. - Balasan yang dibuat oleh pengguna di Eropa dan Jepang tidak termasuk dalam perhitungan
repliesuntuk metrik media cerita.
Webhooks
- Webhook insight untuk Instagram API dengan Instagram Login tidak didukung.
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 |
|
|
Sintaks permintaan
GET "https://<HOST_URL>/<API_VERSION>/<INSTAGRAM_MEDIA_ID>/insights
?metric=<LIST_OF_METRICS>
&period=<LIST_OF_TIME_PERIODS>
&breakdown=<LIST_OF_BREAKDOWNS>
&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 terlama yang tersedia. Pelajari selengkapnya tentang penetapan versi. |
<HOST_URL> | URL penyelenggara yang digunakan aplikasi Anda untuk meminta endpoint. |
<INSTAGRAM_MEDIA_ID> | Wajib. ID Media Instagram. |
Parameter string kueri
| Kunci | Placeholder | Nilai |
|---|---|---|
access_token | <ACCESS_TOKEN> | Wajib. Token akses Pengguna Facebook atau Instagram pengguna aplikasi. |
breakdown | <LIST_OF_BREAKDOWNS> | Menentukan cara membagi hasil menjadi beberapa subset. |
metric | <LIST_OF_METRICS> | Wajib. Daftar metrik yang dipisahkan koma yang ingin Anda tampilkan. |
period | <LIST_OF_TIME_PERIODS> | Daftar periode waktu yang dipisahkan koma yang ingin Anda tampilkan. Nilai bisa berupa:
|
Metrik
Tabel berikut menunjukkan metrik dan jenis objek media yang tersedia.
| Metrik | Jenis Produk Media |
|---|---|
commentsJumlah komentar pada objek media. | FEED (postingan), REELS |
crossposted_viewsTotal berapa kali Media Instagram video diputar, agregat di Instagram dan Facebook. Terjadi jika media tidak dibagikan ke Facebook | REELS |
facebook_viewsTotal berapa kali Media Instagram telah diputar di Facebook. Terjadi jika media tidak dibagikan ke Facebook. Untuk REELS, ini dapat berupa pemutaran dari crossposting atau rekomendasi silang dari Instagram ke Facebook | FEED (postingan), REELS, STORY |
followsJumlah pengguna Instagram yang mengikuti akun profesional Instagram pengguna aplikasi Anda. | FEED (postingan), STORY |
ig_reels_avg_watch_timeJumlah rata-rata waktu yang dihabiskan untuk memutar reel. | REELS |
ig_reels_video_view_total_time
Jumlah total waktu pemutaran reel, termasuk waktu yang dihabiskan untuk memutar ulang reel. Metrik dalam pengembangan. | REELS |
impressionsUntuk media yang dibuat setelah 2 Juli 2024, metrik ini dihentikan. Untuk media yang dibuat sebelum 2 Juli 2024, metrik ini akan tetap tersedia. Total berapa kali objek Media Instagram milik pengguna aplikasi Anda telah dilihat. | FEED (postingan), STORY |
likesJumlah suka pada objek media. | FEED (postingan), REELS |
link_clicksJumlah ketukan pada tautan di cerita Anda. | STORY |
navigationIni adalah jumlah total tindakan yang diambil dari cerita Anda. Ini terdiri dari metrik seperti keluar, meneruskan, kembali, dan cerita berikutnya. Perincian yang tersedia: story_navigation_action_type | STORY |
profile_activityJumlah tindakan yang diambil orang ketika mereka mengunjungi profil Anda setelah terlibat dengan postingan Anda. Perincian yang tersedia: action_type (Tersedia untuk media yang dibuat setelah 26 Oktober 2017.) | FEED (postingan), STORY |
profile_visitsBerapa kali profil Anda dikunjungi. | FEED (postingan), STORY |
reach
Jumlah pengguna Instagram unik yang telah melihat reel ini, setidaknya sekali. Jangkauan berbeda dari impresi, yang dapat mencakup beberapa penayangan reel oleh akun yang sama. Metrik merupakan estimasi. | FEED (postingan), REELS, STORY |
reels_skip_ratePersentase tayangan dari orang-orang yang melewati reel dalam 3 detik pertama. Ini dihitung sebagai jumlah tayangan yang melewati reel selama 3 detik pertama dibagi dengan jumlah tayangan awal. Tayangan awal adalah saat reel mulai diputar untuk pertama kalinya dalam sesi reel. | REELS |
repliesJumlah total balasan (Komentar Instagram) di objek Media Instagram cerita. Nilai tidak termasuk balasan yang dibuat oleh pengguna di beberapa wilayah. Wilayah ini meliputi: Eropa mulai 1 Desember 2020 dan Jepang mulai 14 April 2021. Jika Cerita dibuat oleh pengguna di salah satu wilayah ini, tampilkan nilai 0. | STORY |
repostsJumlah posting ulang pada media Instagram dikurangi jumlah posting ulang yang dihapus. | FEED (postingan), REELS, STORY |
savedJumlah berapa kali media Instagram pengguna aplikasi Anda disimpan oleh pengguna Instagram. | FEED (postingan), REELS |
sharesBerapa kali reel dibagikan. | FEED (postingan), REELS, STORY |
total_interactions
Jumlah suka, simpan, komentar, dan bagikan pada reel, dikurangi jumlah tidak suka, batalkan penyimpanan, dan komentar yang dihapus. Metrik dalam pengembangan. | FEED (postingan), REELS, STORY |
viewsTotal berapa kali Media Instagram telah diputar di Instagram. | FEED (postingan), REELS, STORY |
total_commentsJumlah total komentar pada media di semua platform, termasuk komentar pada media iklan yang dipromosikan/ditingkatkan terkait. Hanya tersedia untuk Instagram API dengan Facebook Login. | FEED (postingan), REELS |
total_likesJumlah total suka pada media di semua platform, termasuk suka pada media iklan yang dipromosikan/ditingkatkan terkait. Hanya tersedia untuk Instagram API dengan Facebook Login. | FEED (postingan), REELS |
total_viewsJumlah total berapa kali media telah dilihat di semua platform, termasuk tayangan dari media yang dipromosikan/ditingkatkan/iklan dan Facebook. Hanya tersedia untuk Instagram API dengan Facebook Login. | FEED (postingan), REELS, STORY |
Perincian
Anda juga dapat menyertakan parameter
breakdown untuk metrik tertentu agar dapat membagi data ke dalam set yang lebih kecil berdasarkan nilai perincian yang ditentukan. Nilai bisa berupa:
nilai breakdown | Nilai tanggapan |
|---|---|
action_typeHanya kompatibel dengan metrik profile_activity.Memerinci hasil berdasarkan komponen profil dalam aplikasi native yang diketuk atau diklik pemirsa setelah melihat profil pengguna aplikasi. |
|
story_navigation_action_typeHanya kompatibel dengan metrik navigation.Memerinci hasil berdasarkan tindakan navigasi yang diambil oleh pemirsa karena melihat media dalam aplikasi native. Menambahkan semua jenis tindakan ini akan memberi Anda total insight navigasi. |
|
CATATAN: Jika Anda meminta metrik yang tidak mendukung perincian, API akan menampikan kesalahan (“
An unknown error has occurred.”), jadi berhati-hatilah jika meminta beberapa metrik dalam satu kueri.Sintaksis tanggapan
Setelah berhasil, aplikasi Anda akan menerima objek JSON yang berisi hasil kueri Anda. Hasil dapat mencakup data berikut, berdasarkan spesifikasi kueri Anda:
{
"data": [
{
"name": "<NAME>",
"period": "<PERIOD>",
"values": [
{
"value": <VALUE>
}
],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"total_value": {
"value":<VALUE>,
"breakdowns": [
{
"dimension_keys": [
"<DIMENSION_KEY_1>",
"<DIMENSION_KEY_2>"
...
],
"results": [
{
"dimension_values": [
"<DIMENSION_VALUE_1>",
"<DIMENSION_VALUE_2>"
...
],
"value": <VALUE>
},
...
]
}
]
},
"id": "<ID>"
}
]
}
Konten tanggapan
| Properti | Jenis Nilai | Deskripsi |
|---|---|---|
data | Array | Array berisi objek yang menggambarkan hasil permintaan Anda. |
name | String | Nama metrik. |
period | String | Periode diminta. Periode secara otomatis diatur ke lifetime dalam permintaan dan tidak dapat diubah, sehingga nilai ini akan selalu lifetime. |
values | Array | Array berisi objek yang menggambarkan nilai metrik yang diminta. |
value | Bilangan bulat | |
title | String | Judul Metrik. |
description | String | Deskripsi metrik. |
id | String | String yang mendeskripsikan parameter jalur kueri. |
total_value | Objek | Objek yang mendeskripsikan nilai perincian yang diminta (jika perincian diminta). |
breakdowns | Array | Array objek yang mendeskripsikan perincian yang diminta dan hasilnya. |
dimension_keys | Array | Array string yang mendeskripsikan perincian yang diminta. |
results | Array | Array objek yang mendeskripsikan masing-masing set perincian. |
dimension_values | String | Array string yang mendeskripsikan nilai set perincian. Nilai dapat dipetakan ke dimension_keys. |
paging | Objek | Objek yang berisi URL yang digunakan untuk meminta set hasil berikutnya. Lihat Hasil Paginasi untuk informasi selengkapnya. |
previous | String | URL untuk mengambil halaman hasil sebelumnya. Lihat Hasil Paginasi untuk informasi selengkapnya. |
next | String | URL untuk mengambil halaman hasil berikutnya. Lihat Hasil Paginasi untuk informasi selengkapnya. |
Contoh
Contoh permintaan metrik postingan
Berikut ini adalah permintaan dari aplikasi yang menggunakan Facebook Login.
curl -i -X GET \
"https://graph.facebook.com/v26.0/17932174733377207/insights?metric=profile_activity&breakdown=action_type&access_token=EAAOc..."
Contoh tanggapan metrik postingan
{ "data": [ { "name": "profile_activity", "period": "lifetime", "values": [ { "value": 4 } ], "title": "Profile activity", "description": "[IG Insights] This header is the name of a metric that appears on an educational info sheet for a particular post, story, video or promotion. This metric is the sum of all profile actions people take when they engage with this content.", "total_value": { "value": 4, "breakdowns": [ { "dimension_keys": [ "action_type" ], "results": [ { "dimension_values": [ "email" ], "value": 1 }, { "dimension_values": [ "text" ], "value": 1 }, { "dimension_values": [ "direction" ], "value": 1 }, { "dimension_values": [ "bio_link_clicked" ], "value": 1 } ] } ] }, "id": "17932174733377207/insights/profile_activity/lifetime" } ] }
Contoh permintaan metrik cerita
Berikut ini adalah permintaan dari aplikasi yang menggunakan Instagram Login.
curl -i -X GET \
"https://graph.instagram.com/v26.0/17969782069736348/insights?metric=navigation&breakdown=story_navigation_action_type&access_token=EAAOc..."
Contoh tanggapan metrik cerita
{ "data": [ { "name": "navigation", "period": "lifetime", "values": [ { "value": 25 } ], "title": "Navigation", "description": "This is the total number of actions taken from your story. These are made up of metrics like exited, forward, back and next story.", "total_value": { "value": 25, "breakdowns": [ { "dimension_keys": [ "story_navigation_action_type" ], "results": [ { "dimension_values": [ "tap_forward" ], "value": 19 }, { "dimension_values": [ "tap_back" ], "value": 4 }, { "dimension_values": [ "tap_exit" ], "value": 1 }, { "dimension_values": [ "swipe_forward" ], "value": 1 } ] } ] }, "id": "17969782069736348/insights/navigation/lifetime" } ] }
Memperbarui
Operasi ini tidak didukung.
Menghapus
Operasi ini tidak didukung.