Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram Reels insights gamit ang API

Ang media insights endpoint ng Instagram, GET /<IG_MEDIA_ID>/insights, ay nagbabalik ng mga sumusunod na metric para sa isang Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time at reels_skip_rate, at crossposted_views at facebook_views para sa crossposted na Reel. Ang plays, clips_replays_count at ig_reels_aggregated_all_plays_count ay na-retire noong Abril 2025, at ang views ang pumalit sa mga ito.

Binabasa ng easyCoexistence ang insights ng isang Reel gamit ang get_social_insights, kaya ang Claude, ChatGPT o sarili ninyong code ay maaaring magtanong kung paano nag-perform ang isang Reel at makakuha ng views, reach, watch time at skip rate diretso mula sa Meta para sa naka-connect na account, kasama ang sariling error ng Meta kapag na-retire ang isang pangalan ng metric.

3 seconds

Ang sinusukat ng reels_skip_rate: ang porsyento ng views na nilaktawan ang Reel sa loob ng unang 3 segundo.

21 Apr 2025

Kailan na-deprecate ang plays, clips_replays_count at ig_reels_aggregated_all_plays_count sa bawat API version.

3 Dec 2025

Kailan idinagdag ang reels_skip_rate, reposts, crossposted_views at facebook_views sa media insights.

48 hours

Gaano katagal maaaring ma-delay ang datos sa likod ng media metrics.

2 years

Gaano katagal iniimbak ng Meta ang media metrics.

Aling mga metric ang ibinabalik ng isang Reel?

Ang mga nakalista sa reference ng media insights ng Meta para sa media_product_type REELS, na binabasa gamit ang GET /<IG_MEDIA_ID>/insights at isang comma-separated na metric parameter. May label ang Meta na estimated o in development ang ilan sa mga ito, gaya ng nakasaad sa tabi ng bawat isa, at binibilang lamang ang likes at comments bilang organic activity:

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.

Ano ang ibinabalik ng isang Reels insights request?

Isang object para sa bawat metric sa data, bawat isa ay may name, period, values, title, description at id. Laging lifetime ang period: itinatakda ito ng Meta para sa media metrics at hindi ito mababago, kaya hindi na ito kailangan sa request. Inilalarawan ng reference ng Meta ang dalawang watch-time metric bilang dami ng oras nang hindi binabanggit ang unit, kaya i-check muna ninyo ang mga ito sa isang Reel na kilala ninyo bago ninyo ito i-chart.

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

Aling mga Reels metric ang na-retire, at ano ang pumalit sa mga ito?

Na-deprecate ng Meta ang unang tatlo mula sa Graph API v22.0 noong 21 Enero 2025, ang araw na ipinakilala nito ang views, at sa lahat ng version noong 21 Abril 2025; ang video_views naman ay mula v21.0 at sa lahat ng version noong 8 Enero 2025. Pumapalya ang request na nagbanggit ng retired na metric, kaya kailangang i-update ang listahan ng metric na isinulat bago ang 2025:

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

Ano ang binibilang ng views at reach sa isang Reel?

Ang views ay ang bilang ng beses na na-play ang Reel sa Instagram, isang metric na may label ng Meta na in development; ang reach ay ang bilang ng natatanging account na nakakita nito kahit isang beses, na may label ng Meta na estimated. Ang likes, comments, views at total_interactions ay binibilang lamang ang organic activity, hindi kasama ang engagement sa mga ad na ginawa mula sa Reel. Ang total_likes, total_comments at total_views, na kasama ang promoted media, ay inaalok lamang sa Facebook Login.

Anong mga limit at delay ang nalalapat?

Itinatakda ng reference ng media insights ng Meta ang mga sumusunod na patakaran para sa mga numero ng isang Reel:

  • Maaaring ma-delay nang hanggang 48 oras ang datos sa likod ng mga metric.
  • Iniimbak ang media metrics nang hanggang 2 taon.
  • Ang nawawala o hindi available na datos ay nagbabalik ng empty data set, hindi 0.
  • Nagbabalik ng error ang crossposted_views at facebook_views para sa Reel na hindi na-crosspost, kaya humiling ng mga ito sa sarili nilang tawag.
  • Ang breakdown na hindi sinusuportahan ng hiniling na metric ay nagpapabagsak sa buong request na may An unknown error has occurred.
  • Sa Instagram Login, kailangan ng token ang instagram_business_basic at instagram_business_manage_insights, sa graph.instagram.com.

Paano binabasa ng get_social_insights ang isang Reel?

Gamit ang account_id ng koneksyon, ang media ID ng Reel bilang object_id, at listahan ng metric. Tumatawag ang easyCoexistence sa GET /<IG_MEDIA_ID>/insights sa graph.instagram.com gamit ang token ng account, ipinapasa ang mga pangalan ng metric sa Meta gaya ng ibinigay, at ibinabalik ang datos ng Meta, o ang sariling error ng Meta kapag na-retire ang isang pangalan. Ibinabalik ng list_social_posts ang mga media ID ng mga kamakailang post at Reel ng account.

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

Mga karaniwang pagkakamali

  • Ang pag-request ng plays o clips_replays_count. Pareho silang na-deprecate sa lahat ng API version noong 21 Abril 2025; humingi ng views.
  • Ang paghahalo ng crossposted_views o facebook_views sa isang pangkalahatang request. Nagbabalik sila ng error para sa Reel na hindi na-crosspost, at ang error ay nagpapabagsak sa tawag.
  • Ang pag-aakala ng unit para sa watch time. Hindi binabanggit ng reference ng Meta ang unit para sa ig_reels_avg_watch_time o ig_reels_video_view_total_time, kaya i-check ito laban sa Reel na kilala ninyo.
  • Ang pagbasa sa empty na resulta bilang zero. Nagbabalik ang Meta ng empty data set kapag hindi umiiral ang datos o kasalukuyang hindi available.
Ginagawa ito gamit ang EasyCoexistence

Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may free trial sa unang 3 araw.

Mga madalas itanong

Bakit empty result ang ibinabalik ng isang Reels insights request?

Nagbabalik ang Meta ng empty data set, hindi 0, kapag hindi umiiral ang datos o kasalukuyang hindi available, at maaaring maantala nang hanggang 48 oras ang datos sa likod ng mga metric.

Paano ko makukuha ang watch time ng Reels mula sa API?

I-request ang ig_reels_avg_watch_time para sa average at ang ig_reels_video_view_total_time para sa kabuuan, kasama ang replays, mula sa GET /<IG_MEDIA_ID>/insights.

Ano ang reels_skip_rate?

Ang porsyento ng mga unang view na nilaktawan ang Reel sa unang 3 segundo nito. Idinagdag ito ng Meta noong 3 Disyembre 2025 at may label itong estimated at in development.

Kasama ba sa Reels insights ang ad views?

Hindi. Ang likes, comments, views at total_interactions ay binibilang lamang ang organic activity; ang total_views, na kasama ang promoted media, ay inaalok lamang sa Facebook Login.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong