Pewarta Proxy

📋 Server Request & Proxy Logs

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

⚙️ Pengaturan Proxy Target

Platform Instagram

Insight Media Instagram

Updated: 11 Sep 2026
Mewakili metrik interaksi sosial di objek Media Instagram pengguna aplikasi Anda.

Membuat

Operasi ini tidak didukung.

Membaca

GET /<INSTAGRAM_MEDIA_ID>/insights
Dapatkan 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 0 untuk metrik individu.
  • Data yang digunakan untuk menghitung metrik dapat tertunda hingga 48 jam.
  • Data metrik disimpan hingga 2 tahun.
  • Metrik seperti comments, likes, views, dan total_interactions hanya melaporkan metrik interaksi organik; interaksi pada iklan yang berisi objek media tidak dihitung. Metrik total_likes, total_comments, dan total_views menampilkan 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 Instagram webhooks dan berlangganan ke kolom story_insights agar 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.
  • Metrik media cerita dengan nilai kurang dari 5 akan menampilkan kode kesalahan 10 dengan pesan (#10) Not enough viewers for the media to show insights.
  • Untuk Cerita yang dibuat oleh pengguna di Eropa dan Jepang, metrik replies sekarang menampilkan nilai 0.
  • Balasan yang dibuat oleh pengguna di Eropa dan Jepang tidak termasuk dalam perhitungan replies untuk 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
  • Token akses Pengguna Instagram
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
  • instagram_basic
  • instagram_manage_insights
  • instagram_business_basic
  • instagram_business_manage_insights
  • instagram_basic
  • instagram_manage_insights
  • pages_read_engagement
Jika pengguna aplikasi diberi peran di Halaman yang terhubung ke akun profesional Instagram pengguna aplikasi Anda melalui Pengelola Bisnis, aplikasi Anda juga akan memerlukan:
  • ads_management
  • ads_read

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>
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:
  • day
  • week
  • days_28
  • month
  • lifetime
  • total_over_range

Metrik

Tabel berikut menunjukkan metrik dan jenis objek media yang tersedia.
Metrik Jenis Produk Media
comments
Jumlah komentar pada objek media.
FEED (postingan), REELS
crossposted_views
Total berapa kali Media Instagram video diputar, agregat di Instagram dan Facebook. Terjadi jika media tidak dibagikan ke Facebook
REELS
facebook_views
Total 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
follows
Jumlah pengguna Instagram yang mengikuti akun profesional Instagram pengguna aplikasi Anda.
FEED (postingan), STORY
ig_reels_avg_watch_time
Jumlah 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
impressions
Untuk 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
likes
Jumlah suka pada objek media.
FEED (postingan), REELS
link_clicks
Jumlah ketukan pada tautan di cerita Anda.
STORY
navigation
Ini 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_activity
Jumlah 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_visits
Berapa 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_rate
Persentase 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
replies
Jumlah 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
reposts
Jumlah posting ulang pada media Instagram dikurangi jumlah posting ulang yang dihapus.
FEED (postingan), REELS, STORY
saved
Jumlah berapa kali media Instagram pengguna aplikasi Anda disimpan oleh pengguna Instagram.
FEED (postingan), REELS
shares
Berapa 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
views
Total berapa kali Media Instagram telah diputar di Instagram.
FEED (postingan), REELS, STORY
total_comments
Jumlah 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_likes
Jumlah 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_views
Jumlah 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_type
Hanya kompatibel dengan metrik profile_activity.
Memerinci hasil berdasarkan komponen profil dalam aplikasi native yang diketuk atau diklik pemirsa setelah melihat profil pengguna aplikasi.
  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
story_navigation_action_type
Hanya 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.
  • SWIPE_FORWARD sama dengan “Cerita Berikutnya”
  • TAP_BACK sama dengan "Kembali"
  • TAP_EXIT sama dengan “Keluar”
  • TAP_FORWARD sama dengan “Teruskan”
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
Untuk data.values.value, menunjukkan jumlah nilai metrik yang diminta.
Untuk data.total_value.value, menunjukkan jumlah nilai perincian yang diminta.
Untuk data.total_value.breakdowns.results.value, menunjukkan jumlah nilai set perincian.
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.