Insight Instagram lewat API: metrik akun dan postingan
API Instagram mengembalikan insight untuk akun profesional dan untuk setiap postingan, Reels, dan Story-nya. Metrik akun mencakup reach, views, accounts engaged, follows and unfollows, likes, comments, saves, dan shares; metrik postingan mencakup reach, views, likes, comments, saves, dan shares. Meta mencatat data bisa tertinggal hingga 48 jam.
easyCoexistence membaca insight Instagram dengan get_social_insights, sehingga Anda dapat bertanya kepada Claude atau ChatGPT bagaimana postingan minggu lalu performanya dan langsung mendapatkan reach, views, likes, comments, saves, dan shares dari Meta, untuk akun atau satu postingan.
Berapa lama data di balik metrik Instagram bisa tertunda.
Di bawah ambang ini, follows and unfollows dan demografi pengikut tidak dikembalikan untuk akun.
Berapa lama Meta menyimpan metrik media.
Berapa lama metrik Story tetap tersedia melalui API.
Kapan impressions berhenti berfungsi di semua versi API, kecuali pada media yang dibuat sebelum 2 Juli 2024; views menggantikannya.
Metrik akun apa saja yang tersedia?
Dibaca dengan GET /<IG_ID>/insights, sebagian besar dengan period=day dan metric_type=total_value:
- reach: jumlah akun unik yang melihat konten, termasuk iklan; bersifat estimasi.
- views: berapa kali konten diputar atau ditampilkan.
accounts_engaged: akun yang berinteraksi dengan konten, termasuk iklan; bersifat estimasi.follows_and_unfollows: follows dan unfollows dalam periode; memerlukan minimal 100 pengikut.- likes, comments, saves, shares, replies, dan reposts, serta
total_interactions. profile_links_taps: ketukan pada tombol alamat bisnis, telepon, email, dan pesan.follower_demographicsdanengaged_audience_demographics: usia, kota, negara, dan jenis kelamin.
Metrik postingan apa saja yang tersedia?
Dibaca dengan GET /<IG_MEDIA_ID>/insights; metrik yang berlaku bergantung pada formatnya. Pada postingan atau Reels, likes, comments, views, dan total interactions hanya menghitung aktivitas organik, bukan interaksi pada iklan yang dibuat darinya.
- Postingan dan Reels: reach, views, likes, comments, saved, shares,
total_interactions, dan reposts. - Khusus Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_time, danreels_skip_rate. - Postingan dan Story: follows,
profile_visits, danprofile_activity. - Story: reach, views, shares, replies, navigation, reposts, dan
total_interactions.
Bagaimana cara kerja period, metric_type, dan breakdown?
Metrik akun menggunakan period=day. metric_type=total_value mengembalikan satu angka untuk rentang waktu dan diperlukan oleh breakdown; time_series mengembalikan nilai per hari dan hanya tersedia untuk reach. Breakdown memecah total berdasarkan media_product_type (postingan, carousel, Reels, Story, dan iklan), berdasarkan follow_type (pengikut atau bukan), atau berdasarkan contact_button_type.
Metrik demografi menggunakan timeframe seperti this_week atau this_month sebagai pengganti since dan until. Tanpa since dan until, metrik lainnya mengambil data 24 jam terakhir. Meminta breakdown yang tidak didukung oleh salah satu metrik yang diminta akan menggagalkan seluruh permintaan dengan kesalahan tidak diketahui.
Ambang batas dan jeda apa yang berlaku?
Aturan Meta tentang kapan sebuah angka muncul dan berapa lama angka itu tetap tersedia:
- Data bisa tertunda hingga 48 jam.
- Akun dengan kurang dari 100 pengikut tidak mendapatkan
follows_and_unfollowsataufollower_demographics;engaged_audience_demographicsmemerlukan 100 interaksi dalam rentang waktu. - Data yang hilang atau tidak tersedia dikembalikan sebagai kumpulan kosong, bukan 0.
- Metrik demografi hanya mengembalikan 45 nilai teratas.
- Metrik akun disimpan hingga 90 hari, metrik media hingga 2 tahun.
Apa yang berbeda untuk Story dan carousel?
Metrik Story hanya tersedia selama 24 jam, dan jika nilainya di bawah 5 akan dikembalikan kesalahan kode 10 (not enough viewers), bukan angka. Balasan dari orang di Eropa dan Jepang tidak dihitung, dan Story yang dibuat oleh akun di sana melaporkan 0 balasan. Dengan Instagram Login tidak ada webhook story_insights, sehingga angka Story harus dibaca selagi Story masih aktif.
Carousel dilaporkan sebagai satu postingan: Meta tidak mengembalikan insight untuk foto dan video di dalamnya.
Mengapa nama metrik berubah?
Karena Meta menghentikan dan mengganti nama metrik antarversi API. impressions dihentikan pada v22.0 dan berhenti berfungsi di semua versi pada 21 April 2025, kecuali pada media yang dibuat sebelum 2 Juli 2024; views diperkenalkan sebagai gantinya. plays, clips_replays_count, dan ig_reels_aggregated_all_plays_count juga dihentikan pada waktu yang sama. video_views dan beberapa deret waktu profil, termasuk profile_views, dihapus lebih awal. Permintaan dengan nama yang sudah dihentikan akan gagal, sehingga daftar metrik yang ditulis untuk versi API sebelumnya mungkin perlu diperbarui.
Kesalahan umum
- Meminta impressions. Metrik ini tidak lagi berfungsi di versi API mana pun; minta views sebagai gantinya.
- Menganggap hasil kosong sebagai nol. Meta mengembalikan kumpulan data kosong ketika sebuah metrik tidak tersedia, dan itu tidak sama dengan tidak ada aktivitas.
- Membaca metrik Story setelah Story berakhir. Metrik tersebut hanya tersedia selama 24 jam.
- Menambahkan breakdown ke permintaan untuk beberapa metrik. Jika salah satunya tidak mendukungnya, seluruh panggilan gagal.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apa yang menggantikan impressions di API Instagram?
views, yang menghitung berapa kali konten diputar atau ditampilkan. Meta menghentikan impressions di semua versi API pada 21 April 2025, kecuali pada media yang dibuat sebelum 2 Juli 2024.
Mengapa akun saya tidak mengembalikan data pengikut?
Meta tidak mengembalikan follows_and_unfollows atau demografi pengikut untuk akun dengan kurang dari 100 pengikut.
Seberapa jauh ke belakang saya bisa membaca insight Instagram?
Hingga 90 hari untuk metrik akun dan hingga 2 tahun untuk metrik media, dengan online_followers hanya mencakup 30 hari terakhir.
Apakah angkanya sudah termasuk iklan?
Sebagian. Reach dan accounts engaged akun sudah termasuk iklan, sedangkan likes, comments, dan views postingan hanya menghitung aktivitas organik.
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