MasukMulai uji coba gratis
easyCoexistence API resmi

Insights Instagram Reels lewat API

Endpoint insights media Instagram, GET /<IG_MEDIA_ID>/insights, mengembalikan metrik berikut untuk sebuah Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time dan reels_skip_rate, ditambah crossposted_views dan facebook_views untuk Reel yang di-crosspost. plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan pada April 2025, dengan views sebagai penggantinya.

easyCoexistence membaca insights sebuah Reel dengan get_social_insights, sehingga Claude, ChatGPT atau kode Anda sendiri bisa menanyakan bagaimana performa sebuah Reel dan langsung mendapatkan views, reach, waktu tonton dan skip rate dari Meta untuk akun yang terhubung, dengan kesalahan Meta sendiri ketika nama metrik sudah dihentikan.

3 seconds

Jendela yang diukur reels_skip_rate: porsi views yang melewati Reel dalam 3 detik pertamanya.

21 Apr 2025

Kapan plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan di setiap versi API.

3 Dec 2025

Kapan reels_skip_rate, reposts, crossposted_views dan facebook_views ditambahkan ke media insights.

48 hours

Seberapa lama data di balik metrik media bisa tertunda.

2 years

Seberapa lama Meta menyimpan metrik media.

Metrik apa saja yang dikembalikan sebuah Reel?

Metrik dalam referensi media insights Meta untuk media_product_type REELS, dibaca dengan GET /<IG_MEDIA_ID>/insights dan parameter metric berupa daftar dipisah koma. Meta menandai beberapa di antaranya sebagai estimasi atau masih dalam pengembangan, sebagaimana dicatat di sebelah masing-masing, dan menghitung likes serta comments hanya sebagai aktivitas organik:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Apa yang dikembalikan permintaan insights Reels?

Satu objek per metrik dalam data, masing-masing dengan name, period, values, title, description dan id. period selalu bernilai lifetime: Meta menetapkannya untuk metrik media dan tidak dapat diubah, sehingga permintaan tidak perlu menyertakannya. Referensi Meta menggambarkan dua metrik waktu tonton sebagai jumlah waktu tanpa menyebut satuannya, jadi periksa keduanya terhadap Reel yang Anda kenal sebelum membuat grafik darinya.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

Metrik Reels mana yang dihentikan, dan apa penggantinya?

Meta menghentikan tiga metrik pertama mulai Graph API v22.0 pada 21 Januari 2025, hari ketika Meta memperkenalkan views, dan di setiap versi pada 21 April 2025; video_views dihentikan mulai v21.0 dan di setiap versi pada 8 Januari 2025. Permintaan yang menyebut metrik yang sudah dihentikan akan gagal, jadi daftar metrik yang ditulis sebelum 2025 perlu diperbarui:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Apa yang dihitung views dan reach pada sebuah Reel?

views adalah jumlah kali Reel diputar di Instagram, metrik yang oleh Meta ditandai sebagai masih dalam pengembangan; reach adalah jumlah akun unik yang melihatnya setidaknya sekali, yang oleh Meta ditandai sebagai estimasi. likes, comments, views dan total_interactions hanya menghitung aktivitas organik, tidak termasuk interaksi pada iklan yang dibuat dari Reel. total_likes, total_comments dan total_views, yang mencakup media berbayar, hanya tersedia dengan Facebook Login.

Batasan dan penundaan apa yang berlaku?

Referensi media insights Meta menetapkan aturan berikut untuk angka sebuah Reel:

  • Data di balik metrik bisa tertunda hingga 48 jam.
  • Metrik media disimpan hingga 2 tahun.
  • Data yang hilang atau tidak tersedia mengembalikan data kosong, bukan 0.
  • crossposted_views dan facebook_views menghasilkan kesalahan untuk Reel yang tidak di-crosspost, jadi minta keduanya dalam panggilan tersendiri.
  • Breakdown yang tidak didukung metrik yang diminta menggagalkan seluruh permintaan dengan pesan kesalahan tak dikenal.
  • Dengan Instagram Login, token memerlukan instagram_business_basic dan instagram_business_manage_insights, di graph.instagram.com.

Bagaimana get_social_insights membaca sebuah Reel?

Dengan account_id koneksi, ID media Reel sebagai object_id, dan daftar metrik. easyCoexistence memanggil GET /<IG_MEDIA_ID>/insights di graph.instagram.com dengan token akun, meneruskan nama metrik ke Meta apa adanya, dan mengembalikan data Meta, atau kesalahan Meta sendiri ketika sebuah nama sudah dihentikan. list_social_posts mengembalikan ID media dari postingan dan Reel terbaru akun.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Kesalahan umum

  • Meminta plays atau clips_replays_count. Keduanya dihentikan di setiap versi API pada 21 April 2025; minta views.
  • Memasukkan crossposted_views atau facebook_views ke dalam permintaan umum. Keduanya menghasilkan kesalahan untuk Reel yang tidak di-crosspost, dan kesalahan itu menggagalkan panggilan.
  • Mengira ada satuan untuk waktu tonton. Meta tidak menyebut satuan untuk ig_reels_avg_watch_time atau ig_reels_video_view_total_time, jadi periksa terhadap Reel yang dikenal.
  • Membaca hasil kosong sebagai nol. Meta mengembalikan data kosong ketika data tidak ada atau sedang tidak tersedia.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Mengapa permintaan insights Reels mengembalikan hasil kosong?

Meta mengembalikan data kosong, bukan 0, ketika data tidak ada atau sedang tidak tersedia, dan data di balik metrik bisa tertinggal hingga 48 jam.

Bagaimana cara mendapatkan waktu tonton Reels dari API?

Minta ig_reels_avg_watch_time untuk rata-rata dan ig_reels_video_view_total_time untuk total, termasuk replay, dari GET /<IG_MEDIA_ID>/insights.

Apa itu reels_skip_rate?

Persentase views awal yang melewati Reel dalam 3 detik pertamanya. Meta menambahkannya pada 3 Desember 2025 dan menandainya sebagai estimasi dan masih dalam pengembangan.

Apakah insights Reels mencakup views iklan?

Tidak. likes, comments, views dan total_interactions hanya menghitung aktivitas organik; total_views, yang mencakup media berbayar, hanya tersedia dengan Facebook Login.

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