Insight Platform Instagram
Updated: 20 Okt 2026
Salinan LLM
Panduan ini menunjukkan kepada Anda cara mendapatkan insight untuk media dan akun profesional Instagram pengguna aplikasi Anda menggunakan Platform Instagram.
Dalam panduan ini, kami akan menggunakan pengguna Instagram dan akun profesional Instagram secara bergantian. Objek Pengguna Instagram mewakili akun profesional Instagram pengguna aplikasi Anda.
Insight Instagram sekarang tersedia untuk Instagram API dengan Instagram Login. Pelajari selengkapnya.
Sebelum memulai
Anda akan memerlukan hal-hal berikut:
Persyaratan
Panduan ini berasumsi Anda telah membaca Ringkasan Platform Instagram dan menerapkan komponen yang dibutuhkan untuk menggunakan API ini, seperti alur login Meta dan server webhooks untuk menerima notifikasi.
| 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 |
|
|
Level Akses
- Advanced Access jika aplikasi Anda melayani akun profesional Instagram yang bukan milik Anda atau tidak Anda kelola
- Akses Standar jika aplikasi Anda melayani akun profesional Instagram yang Anda miliki atau kelola dan telah ditambahkan ke aplikasi Anda di Dasbor Aplikasi
Endpoint
GET /<INSTAGRAM_MEDIA_ID>/insights— Mendapatkan metrik pada objek mediaGET /<INSTAGRAM_ACCOUNT_ID>/insights— Mendapatkan metrik pada Akun Bisnis Instagram atau Akun Kreator Instagram.
Lihat dokumentasi referensi setiap endpoint untuk metrik, parameter, dan persyaratan izin tambahan.
UTC
Cap waktu dalam tanggapan API menggunakan UTC dengan offset nol dan diformat menggunakan ISO-8601. Contoh:
2019-04-05T07:56:32+0000Langganan peristiwa webhook
Batasan
Insight media
- Metrik seperti
comments,likes, danviewshanya menampilkan interaksi pada media Instagram target dan tidak menyertakan data dari platform lain. Contoh:commentsmenampilkan jumlah komentar pada sebuah foto, tetapi tidak menampilkan komentar pada iklan yang berisi foto tersebut. Gunakantotal_comments,total_likes, dantotal_viewspada endpoint Insights untuk mendapatkan jumlah agregat yang menyertakan interaksi dari media iklan yang dipromosikan/ditingkatkan. Total metrik ini hanya tersedia untuk Instagram API dengan Facebook Login. - 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.
Insight akun
- Beberapa metrik tidak tersedia pada akun Instagram dengan pengikut kurang dari 100.
- Data Metrik Pengguna disimpan hingga 90 hari.
- Anda hanya bisa mendapatkan insight per pengguna setiap kalinya.
- Anda tidak bisa mendapatkan insight untuk Halaman Facebook.
- Jika data insight yang Anda minta tidak ada atau saat ini tidak tersedia, API akan menampilkan set data kosong, bukan
0untuk masing-masing metrik.
Contoh
Permintaan akun Instagram
Contoh API Instagram dengan Facebook Login berikut ini mendapatkan jumlah
impressions, profile_views, dan reach untuk akun profesional Instagram pengguna aplikasi Anda selama periode 24 jam.Untuk mendapatkan metrik akun bisnis atau kreator Instagram, kuerilah endpoint
GET /<INSTAGRAM_USER_ID>/insights dengan parameter metrics yang diatur ke daftar yang dipisahkan koma dari metrik, impressions, profile_views, dan reach, serta period yang diatur ke day.GET graph.facebook.com/17841405822304914/insights
?metric=impressions,reach,profile_views
&period=day
Contoh Tanggapan
Jika berhasil, aplikasi Anda akan menerima array untuk setiap metrik yang mencakup deskripsi metrik, ID metrik, nama dan judul, periode waktu pengukuran metrik, dan nilai metrik.
{
"data": [
{
"name": "impressions",
"period": "day",
"values": [
{
"value": 32,
"end_time": "2018-01-11T08:00:00+0000"
},
{
"value": 32,
"end_time": "2018-01-12T08:00:00+0000"
}
],
"title": "Impressions",
"description": "Total number of times the Business Account's media objects have been viewed",
"id": "instagram_business_account_id/insights/impressions/day"
},
{
"name": "reach",
"period": "day",
"values": [
{
"value": 12,
"end_time": "2018-01-11T08:00:00+0000"
},
{
"value": 12,
"end_time": "2018-01-12T08:00:00+0000"
}
],
"title": "Reach",
"description": "Total number of times the Business Account's media objects have been uniquely viewed",
"id": "instagram_business_account_id/insights/reach/day"
},
{
"name": "profile_views",
"period": "day",
"values": [
{
"value": 15,
"end_time": "2018-01-11T08:00:00+0000"
},
{
"value": 15,
"end_time": "2018-01-12T08:00:00+0000"
}
],
"title": "Profile Views",
"description": "Total number of users who have viewed the Business Account's profile within the specified period",
"id": "instagram_business_account_id/insights/profile_views/day"
}
]
}
Permintaan media Instagram
Contoh API Instagram dengan Login Instagram berikut ini mendapatkan jumlah
engagement, impressions, dan reach untuk media Instagram pengguna aplikasi Anda selama periode 24 jam.Untuk mendapatkan metrik untuk media akun bisnis atau kreator Instagram, kuerikan endpoint
GET /<INSTAGRAM_MEDIA_ID>/insights dengan parameter metrics yang diatur ke daftar yang dipisahkan koma dari metrik, engagement, impressions, dan reach, dan period yang diatur ke day.GET graph.instagram.com/17841491440582230/insights
?metric=engagement,impressions,reach
Contoh Tanggapan
Jika berhasil, aplikasi Anda akan menerima array untuk setiap metrik yang mencakup deskripsi metrik, ID metrik, nama dan judul, periode waktu pengukuran metrik, dan nilai metrik.
{
"data": [
{
"name": "engagement",
"period": "lifetime",
"values": [
{
"value": 8
}
],
"title": "Engagement",
"description": "Total number of likes and comments on the media object",
"id": "media_id/insights/engagement/lifetime"
},
{
"name": "impressions",
"period": "lifetime",
"values": [
{
"value": 13
}
],
"title": "Impressions",
"description": "Total number of times the media object has been seen",
"id": "media_id/insights/impressions/lifetime"
},
{
"name": "reach",
"period": "lifetime",
"values": [
{
"value": 13
}
],
"title": "Reach",
"description": "Total number of unique accounts that have seen the media object",
"id": "media_id/insights/reach/lifetime"
}
]
}
Langkah Berikutnya
Kunjungi Referensi API untuk melihat semua metrik yang tersedia untuk akun bisnis dan kreator Instagram dan objek Instagram Media mereka.