Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Insight Reels Instagram melalui API

Endpoint insights media Instagram, GET /<IG_MEDIA_ID>/insights, mengembalikan metrik ini untuk 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, serta crossposted_views dan facebook_views untuk Reel yang dikongsi silang. plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan pada April 2025, dengan views menggantikannya.

easyCoexistence membaca insights Reel dengan get_social_insights, jadi Claude, ChatGPT atau kod anda sendiri boleh bertanya bagaimana Reel berprestasi dan mendapat tontonan, capaian, masa tontonan dan kadar langkau terus daripada Meta bagi akaun yang disambungkan, dengan ralat Meta sendiri apabila nama metrik dihentikan.

3 seconds

Tetingkap yang diukur oleh reels_skip_rate: bahagian tontonan yang melangkau Reel dalam 3 saat pertama.

21 Apr 2025

Bila plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dinyahguna dalam setiap versi API.

3 Dec 2025

Bila reels_skip_rate, reposts, crossposted_views dan facebook_views ditambah pada insights media.

48 hours

Berapa lama data di sebalik metrik media boleh tertangguh.

2 years

Berapa lama Meta menyimpan metrik media.

Metrik apa yang dikembalikan oleh Reel?

Metrik yang disenaraikan dalam rujukan insights media Meta untuk media_product_type REELS, dibaca dengan GET /<IG_MEDIA_ID>/insights dan parameter metrik dipisahkan koma. Meta melabelkan beberapa metrik sebagai anggaran atau dalam pembangunan, seperti yang dinyatakan di sebelahnya, dan hanya mengira suka dan ulasan sebagai aktiviti 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 oleh permintaan insights Reels?

Satu objek bagi setiap metrik dalam data, setiap satu dengan name, period, values, title, description dan id. period sentiasa berbunyi lifetime: Meta menetapkannya untuk metrik media dan ia tidak boleh diubah, jadi permintaan tidak memerlukannya. Rujukan Meta menerangkan dua metrik masa tontonan sebagai jumlah masa tanpa menamakan unit, jadi semak dengan Reel yang anda kenali sebelum memaparkannya dalam carta.

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 gantiannya?

Meta menghentikan tiga yang pertama dari Graph API v22.0 pada 21 Januari 2025, hari ia memperkenalkan views, dan dalam setiap versi pada 21 April 2025; video_views bermula dari v21.0 dan dalam setiap versi pada 8 Januari 2025. Permintaan yang menamakan metrik yang dihentikan akan gagal, jadi senarai metrik yang ditulis sebelum 2025 perlu dikemas kini:

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 dikira oleh views dan reach pada Reel?

views ialah bilangan kali Reel dimainkan di Instagram, metrik yang dilabelkan Meta sebagai dalam pembangunan; reach ialah bilangan akaun unik yang melihatnya sekurang-kurangnya sekali, yang dilabelkan Meta sebagai anggaran. likes, comments, views dan total_interactions hanya mengira aktiviti organik, tidak termasuk interaksi pada iklan yang dibuat daripada Reel. total_likes, total_comments dan total_views, yang merangkumi media dipromosikan, hanya ditawarkan dengan Facebook Login sahaja.

Had dan kelewatan apa yang terpakai?

Rujukan insights media Meta menetapkan peraturan ini untuk nombor Reel:

  • Data di sebalik metrik boleh tertangguh sehingga 48 jam.
  • Metrik media disimpan sehingga 2 tahun.
  • Data yang hilang atau tidak tersedia mengembalikan set data kosong, bukan 0.
  • crossposted_views dan facebook_views menghasilkan ralat bagi Reel yang tidak dikongsi silang, jadi mintalah kedua-duanya dalam panggilan tersendiri.
  • Pecahan yang tidak disokong oleh metrik yang diminta menggagalkan keseluruhan permintaan dengan An unknown error has occurred.
  • Dengan Instagram Login, token memerlukan instagram_business_basic dan instagram_business_manage_insights, pada graph.instagram.com.

Bagaimana get_social_insights membaca Reel?

Dengan account_id sambungan, ID media Reel sebagai object_id dan senarai metrik. easyCoexistence memanggil GET /<IG_MEDIA_ID>/insights pada graph.instagram.com dengan token akaun, menghantar nama metrik kepada Meta seperti yang diberikan dan memulangkan data Meta, atau ralat Meta sendiri apabila nama dihentikan. list_social_posts memulangkan ID media bagi siaran dan Reel terkini akaun.

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"
  ]
}

Kesilapan biasa

  • Meminta plays atau clips_replays_count. Kedua-duanya dihentikan dalam setiap versi API pada 21 April 2025; mintalah views.
  • Mencampurkan crossposted_views atau facebook_views dalam permintaan umum. Ia menghasilkan ralat bagi Reel yang tidak dikongsi silang, dan ralat itu menggagalkan panggilan.
  • Menganggap unit bagi masa tontonan. Rujukan Meta tidak menamakan sebarang unit bagi ig_reels_avg_watch_time atau ig_reels_video_view_total_time, jadi semak dengan Reel yang diketahui.
  • Membaca hasil kosong sebagai sifar. Meta memulangkan set data kosong apabila data tidak wujud atau pada masa ini tidak tersedia.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 sebulan bagi setiap sambungan, menurun kepada US$ 0.75 apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Mengapa permintaan insights Reels memulangkan hasil kosong?

Meta memulangkan set data kosong, bukan 0, apabila data tidak wujud atau pada masa ini tidak tersedia, dan data di sebalik metrik boleh ketinggalan sehingga 48 jam.

Bagaimana saya mendapatkan masa tontonan Reels daripada API?

Mintalah ig_reels_avg_watch_time untuk purata dan ig_reels_video_view_total_time untuk jumlah, termasuk main semula, daripada GET /<IG_MEDIA_ID>/insights.

Apakah reels_skip_rate?

Peratusan tontonan awal yang melangkau Reel dalam 3 saat pertama. Meta menambahkannya pada 3 Disember 2025 dan melabelkannya sebagai anggaran dan dalam pembangunan.

Adakah insights Reels termasuk tontonan iklan?

Tidak. likes, comments, views dan total_interactions hanya mengira aktiviti organik; total_views, yang merangkumi media dipromosikan, hanya ditawarkan dengan Facebook Login sahaja.

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