Insights Instagram melalui API: metrik akaun dan siaran
API Instagram mengembalikan insights untuk akaun profesional dan untuk setiap siarannya, Reel serta Story. Metrik akaun merangkumi capaian, tontonan, accounts_engaged, ikutan dan nyahikutan, suka, komen, simpanan dan kongsi; metrik siaran merangkumi capaian, tontonan, suka, komen, simpanan dan kongsi. Meta menyatakan data boleh tertangguh sehingga 48 jam.
easyCoexistence membaca insights Instagram dengan get_social_insights, supaya anda boleh bertanya kepada Claude atau ChatGPT bagaimana siaran minggu lepas, dan mendapat capaian, tontonan, suka, komen, simpanan dan kongsi terus daripada Meta, untuk akaun atau untuk satu siaran.
Berapa lama data di sebalik metrik Instagram boleh tertangguh.
Di bawah bilangan ini, follows_and_unfollows dan demografi pengikut tidak dikembalikan untuk akaun.
Tempoh Meta menyimpan metrik media.
Tempoh metrik Story kekal tersedia melalui API.
Impressions berhenti berfungsi dalam semua versi API, kecuali pada media yang dicipta sebelum 2 Julai 2024; views menggantikannya.
Metrik akaun yang manakah tersedia?
Baca dengan GET /<IG_ID>/insights, kebanyakannya dengan period=day dan metric_type=total_value:
- reach: akaun unik yang melihat kandungan, termasuk iklan; anggaran.
- views: bilangan kali kandungan dimainkan atau dipaparkan.
accounts_engaged: akaun yang berinteraksi dengan kandungan, termasuk iklan; anggaran.follows_and_unfollows: ikutan dan nyahikutan dalam tempoh; memerlukan sekurang-kurangnya 100 pengikut.- likes, comments, saves, shares, replies dan reposts, serta
total_interactions. profile_links_taps: ketukan pada butang alamat perniagaan, panggilan, e-mel dan mesej teks.follower_demographicsdanengaged_audience_demographics: umur, bandar, negara dan jantina.
Metrik siaran yang manakah tersedia?
Baca dengan GET /<IG_MEDIA_ID>/insights; metrik yang terpakai bergantung pada format. Pada siaran atau Reel, likes, comments, views dan total_interactions hanya mengira aktiviti organik, bukan interaksi pada iklan yang dibuat daripadanya.
- Siaran dan Reel: reach, views, likes, comments, saved, shares,
total_interactionsdan reposts. - Reel sahaja:
ig_reels_avg_watch_time,ig_reels_video_view_total_timedanreels_skip_rate. - Siaran dan Story: follows,
profile_visitsdanprofile_activity. - Story: reach, views, shares, replies, navigation, reposts dan
total_interactions.
Bagaimana period, metric_type dan pecahan berfungsi?
Metrik akaun menggunakan period=day. metric_type=total_value mengembalikan satu nilai untuk julat dan inilah yang diperlukan oleh pecahan; time_series mengembalikan nilai setiap hari dan tersedia untuk reach. Pecahan membahagikan jumlah mengikut media_product_type (siaran, carousel, Reel, Story dan iklan), mengikut follow_type (pengikut atau bukan pengikut) atau mengikut contact_button_type.
Metrik demografi menggunakan timeframe seperti this_week atau this_month dan bukannya since dan until; tanpa since dan until, metrik lain merangkumi 24 jam terakhir. Meminta pecahan yang tidak disokong oleh salah satu metrik yang diminta akan menggagalkan keseluruhan permintaan dengan ralat tidak diketahui.
Apakah ambang dan kelewatan yang terpakai?
Peraturan Meta untuk bila nombor muncul dan berapa lama ia kekal tersedia:
- Data boleh tertangguh sehingga 48 jam.
- Akaun yang mempunyai kurang 100 pengikut tidak menerima
follows_and_unfollowsataufollower_demographics;engaged_audience_demographicsmemerlukan 100 interaksi dalam tempoh tersebut. - Data yang hilang atau tidak tersedia dikembalikan sebagai set kosong, bukan sebagai 0.
- Metrik demografi hanya mengembalikan 45 nilai teratas.
- Metrik akaun disimpan sehingga 90 hari, metrik media sehingga 2 tahun.
Apakah yang berbeza untuk Story dan carousel?
Metrik Story hanya tersedia selama 24 jam, dan nilai di bawah 5 mengembalikan kod ralat 10 (tidak cukup penonton), bukannya nombor. Balasan daripada orang di Eropah dan Jepun tidak dimasukkan, dan Story yang dicipta oleh akaun di sana melaporkan 0 balasan. Dengan Instagram Login tiada webhook story_insights, jadi nombor Story perlu dibaca semasa Story itu masih aktif.
Carousel dilaporkan sebagai satu siaran: Meta tidak mengembalikan insights untuk foto dan video di dalamnya.
Mengapa nama metrik berubah?
Kerana Meta menamatkan dan menamakan semula metrik antara versi API. impressions dinyahgunakan untuk v22.0 dan berhenti berfungsi dalam semua versi pada 21 April 2025, kecuali pada media yang dicipta sebelum 2 Julai 2024, dengan views diperkenalkan menggantikannya; plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan serentak. video_views dan beberapa siri masa profil, antaranya profile_views, digugurkan lebih awal. Permintaan dengan nama yang telah ditamatkan akan gagal, jadi senarai metrik yang ditulis untuk versi API yang lebih awal mungkin perlu dikemas kini.
Kesilapan biasa
- Meminta impressions. Ia tidak lagi berfungsi dalam mana-mana versi API; minta views sebagai gantinya.
- Menganggap hasil kosong sebagai sifar. Meta mengembalikan set data kosong apabila metrik tidak tersedia, dan itu tidak sama dengan tiada aktiviti.
- Membaca metrik Story selepas Story tamat. Ia hanya tersedia selama 24 jam.
- Menambah pecahan pada permintaan untuk beberapa metrik. Jika salah satunya tidak menyokongnya, keseluruhan panggilan gagal.
Harga daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Apakah yang menggantikan impressions dalam API Instagram?
views, yang mengira bilangan kali kandungan dimainkan atau dipaparkan. Meta menamatkan impressions dalam semua versi API pada 21 April 2025, kecuali pada media yang dicipta sebelum 2 Julai 2024.
Mengapa akaun saya tidak mengembalikan data pengikut?
Meta tidak mengembalikan follows_and_unfollows atau demografi pengikut untuk akaun yang mempunyai kurang 100 pengikut.
Sejauh mana ke belakang saya boleh membaca insights Instagram?
Sehingga 90 hari metrik akaun dan sehingga 2 tahun metrik media, dengan online_followers meliputi 30 hari terakhir sahaja.
Adakah nombor termasuk iklan?
Sebahagiannya. Capaian dan accounts_engaged bagi sesebuah akaun termasuk iklan, manakala suka, komen dan tontonan bagi sesebuah siaran hanya mengira aktiviti organik.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada