MasukMulai uji coba gratis
easyCoexistence API resmi

Insights Story Instagram melalui API

Endpoint insights media Instagram mengembalikan metrik ini untuk Story selama masih tayang: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts dan total_interactions. navigation dirinci menurut story_navigation_action_type menjadi TAP_FORWARD, TAP_BACK, TAP_EXIT dan SWIPE_FORWARD. Metrik Story tersedia selama 24 jam, nilai di bawah 5 mengembalikan kesalahan 10, dan Instagram Login tidak memiliki webhook story_insights.

easyCoexistence membaca insights Story dengan get_social_insights selama Story masih tayang, sehingga Claude, ChatGPT, atau kode Anda sendiri bisa menanyakan bagaimana Story hari ini dan mendapatkan reach, views, replies, shares, dan navigation langsung dari Meta untuk akun yang terhubung.

24 hours

Berapa lama metrik media Story tersedia melalui API.

Error 10

Dikembalikan sebagai pengganti nilai ketika metrik Story di bawah 5: penonton belum cukup agar media bisa menampilkan insights.

Facebook Login

Satu-satunya pengaturan yang diberikan panduan insights Meta untuk webhook story_insights; tidak didukung dengan Instagram Login.

0

Nilai replies untuk Story yang dibuat akun di Eropa atau Jepang.

22 Jun 2026

Saat Meta menambahkan link_clicks untuk Story, yang menghitung ketukan pada tautan seperti stiker tautan, hanya untuk Facebook Login.

Metrik apa saja yang dikembalikan Story?

Yang tercantum dalam referensi insights media Meta untuk media_product_type STORY, dibaca dengan GET /<STORY_MEDIA_ID>/insights selama Story masih tayang. Dengan Instagram Login, permintaan diarahkan ke graph.instagram.com dengan token yang memuat instagram_business_basic dan instagram_business_manage_insights, dan period selalu lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Bagaimana cara membaca navigasi per aksi?

Minta navigation sendiri dengan breakdown=story_navigation_action_type. Totalnya ada di total_value.value dan tiap aksi di total_value.breakdowns[].results, yang jumlahnya sama dengan total: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) dan SWIPE_FORWARD (Next Story). Contoh respons Meta menulis nilainya dengan huruf kecil:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "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": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Berapa lama metrik Story tersedia?

24 jam. Meta hanya menyediakan metrik media Story selama 24 jam, sepanjang masa hidup Story itu sendiri, sementara data di baliknya bisa tertinggal hingga 48 jam. Bacalah sesuai jadwal selama Story masih tayang dan simpan nilai terakhir yang Anda dapatkan. Meta mencatat bahwa data masih bisa datang setelah Story kedaluwarsa jika Story ditambahkan ke sorotan, dan bahwa permintaan API, webhook, dan aplikasi kemudian bisa menampilkan hasil yang berbeda.

Mengapa metrik Story mengembalikan kesalahan 10?

Karena nilainya di bawah 5. Meta mengembalikan kode kesalahan 10 dengan pesan (#10) Not enough viewers for the media to show insights sebagai pengganti angka kecil, sehingga Story yang dilihat sedikit orang bisa gagal ketika Story yang lebih ramai berhasil. Anggap sebagai jumlah rendah, bukan gangguan, dan jangan mencoba kembali secara berulang.

Mengapa balasan Story bernilai 0?

Aturan regional. Balasan dari orang di Eropa, sejak 1 Desember 2020, dan di Jepang, sejak 14 April 2021, tidak dihitung dalam metrik replies, sehingga Story yang dibuat akun di salah satu wilayah tersebut mengembalikan 0. Referensi Meta mendefinisikan replies sebagai IG Comments pada objek media Story.

Apakah ada webhook story_insights?

Tidak dengan Instagram Login. Tabel field Meta menandai story_insights tidak tersedia di sana, referensi insights media menyatakan webhook insights tidak didukung dengan Instagram Login, dan panduan insights-nya mencantumkan story_insights hanya untuk Facebook Login. Dengan Facebook Login, field ini aktif saat Story kedaluwarsa, hanya membawa 24 jam pertama metrik, dan mengembalikan jumlah di bawah 5 sebagai -1.

Metrik Story mana yang sudah dihentikan atau dibatasi?

Beberapa nama masih muncul di kode lama atau di changelog Meta:

  • impressions: tidak digunakan lagi untuk media yang dibuat setelah 2 Juli 2024, sehingga Story saat ini melaporkan views.
  • taps_forward, taps_back dan exits: dihentikan pada 11 Desember 2023; navigation, dirinci menurut story_navigation_action_type, melaporkan aksi yang sama.
  • link_clicks: ketukan pada tautan seperti stiker tautan, ditambahkan pada 22 Juni 2026 hanya untuk Facebook Login.
  • total_views: tayangan di semua permukaan, termasuk media berbayar, tersedia hanya dengan Facebook Login.

Bagaimana get_social_insights membaca Story?

Dengan ID media Story sebagai object_id, yang dikembalikan publish_instagram_post sebagai media_id saat ia mempublikasikan Story, dan metrik sebagai daftar. Minta navigation dalam permintaan terpisah dengan params diisi breakdown story_navigation_action_type, karena breakdown yang tidak didukung oleh satu metrik yang diminta akan menggagalkan seluruh permintaan. Kesalahan Meta, termasuk kesalahan 10, dikembalikan persis seperti yang ditulis Meta.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Kesalahan umum

  • Membaca metrik Story keesokan harinya. Meta hanya menyediakannya selama 24 jam, jadi kumpulkan saat Story masih tayang.
  • Mencoba kembali kesalahan 10 berulang kali. Artinya nilainya di bawah 5 karena penonton belum cukup, dan nilainya tidak akan berubah sampai lebih banyak orang melihat Story.
  • Meminta navigation dengan breakdown bersama metrik lain. story_navigation_action_type hanya berfungsi dengan navigation, dan breakdown yang tidak didukung menggagalkan seluruh permintaan.
  • Menunggu story_insights dengan Instagram Login. Meta tidak menyediakan webhook itu di sana, jadi lakukan polling pada endpoint insights sebelum Story kedaluwarsa.
Melakukan ini dengan EasyCoexistence

Story dikirim dengan publish_instagram_post. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah insights Story berubah setelah Story ditambahkan ke sorotan?

Bisa. Meta menyatakan Story yang ditambahkan ke sorotan mungkin tetap menerima data setelah kedaluwarsa, jadi API, webhook, dan aplikasi bisa tidak sepakat untuk sementara waktu.

Apakah total_views berfungsi untuk Story dengan Instagram Login?

Tidak. total_views, yang menghitung tayangan di semua permukaan termasuk media berbayar, hanya tersedia dengan Facebook Login; dengan Instagram Login, mintalah views.

Bisakah API membaca klik pada stiker tautan di Story Instagram?

Hanya dengan Facebook Login. Meta menambahkan link_clicks untuk Story pada 22 Juni 2026, yang menghitung ketukan pada tautan seperti stiker tautan, dan tidak menyediakannya dengan Instagram Login.

Apa yang menggantikan taps_forward, taps_back dan exits?

navigation, dirinci menurut story_navigation_action_type menjadi TAP_FORWARD, TAP_BACK, TAP_EXIT dan SWIPE_FORWARD. Metrik lama dihentikan pada 11 Desember 2023.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada