Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram insights sa API: metrics ng account at post

Nagbibigay ang Instagram API ng insights para sa professional account at sa bawat post, Reel, at Story nito. Kasama sa metrics ng account ang reach, views, accounts engaged, follows and unfollows, likes, comments, saves, at shares; kasama sa metrics ng post ang reach, views, likes, comments, saves, at shares. Ayon sa Meta, maaaring mahuli ang data nang hanggang 48 oras.

Binabasa ng easyCoexistence ang insights ng Instagram gamit ang get_social_insights, kaya maitatanong ninyo sa Claude o ChatGPT kung ano ang naging resulta ng mga post noong nakaraang linggo at makukuha agad ang reach, views, likes, comments, saves, at shares mula mismo sa Meta, para sa account o para sa isang post.

48 hours

Gaano katagal maaaring maantala ang data sa likod ng Instagram metrics.

100 followers

Sa mas mababang threshold na ito, hindi ibinabalik para sa account ang follows and unfollows at ang follower demographics.

2 years

Gaano katagal iniimbak ng Meta ang media metrics.

24 hours

Gaano katagal nananatiling available ang Story metrics sa pamamagitan ng API.

21 Apr 2025

Kailan tumigil sa paggana ang impressions sa lahat ng API version, maliban sa media na ginawa bago ang 2 Hulyo 2024; pinalitan ito ng views.

Aling mga metric ng account ang available?

Basahin gamit ang GET /<IG_ID>/insights, kadalasan may period=day at metric_type=total_value:

  • reach: natatanging account na nakakita ng content, kasama ang ads; tinatantiya.
  • views: beses na na-play o naipakita ang content.
  • accounts_engaged: account na nakipag-interact sa content, kasama ang ads; tinatantiya.
  • follows_and_unfollows: mga follow at unfollow sa panahon; kailangan ng hindi bababa sa 100 follower.
  • likes, comments, saves, shares, replies at reposts, pati total_interactions.
  • profile_links_taps: pag-tap sa mga button ng address ng negosyo, tawag, email, at text.
  • follower_demographics at engaged_audience_demographics: edad, lungsod, bansa, at kasarian.

Aling mga metric ng post ang available?

Basahin gamit ang GET /<IG_MEDIA_ID>/insights; nakadepende sa format kung aling metric ang naaangkop. Sa post o Reel, ang likes, comments, views, at total interactions ay bilang lamang ng organic activity, hindi ang engagement sa ads na ginawa mula rito.

  • Posts at Reels: reach, views, likes, comments, saved, shares, total_interactions, at reposts.
  • Reels lang: ig_reels_avg_watch_time, ig_reels_video_view_total_time, at reels_skip_rate.
  • Posts at Stories: follows, profile_visits, at profile_activity.
  • Stories: reach, views, shares, replies, navigation, reposts, at total_interactions.

Paano gumagana ang period, metric_type, at breakdowns?

Ang account metrics ay kumukuha ng period=day. Ibinabalik ng metric_type=total_value ang isang numero para sa buong saklaw, at ito ang kailangan ng breakdowns; ang time_series naman ay nagbibigay ng value kada araw at available para sa reach. Hinahati ng breakdowns ang kabuuan ayon sa media_product_type (posts, carousels, Reels, Stories, at ads), ayon sa follow_type (follower o hindi), o ayon sa contact_button_type.

Ang demographic metrics ay gumagamit ng timeframe gaya ng this_week o this_month sa halip na since at until. Kapag walang since at until, ang ibang metrics ay tumitingin sa nakaraang 24 na oras. Ang paghingi ng breakdown na hindi sinusuportahan ng isa sa hiniling na metrics ay nagpapabagsak sa buong hiling na may unknown error.

Anong threshold at delay ang nalalapat?

Mga patakaran ng Meta kung kailan lumalabas ang isang numero at gaano katagal ito nananatiling available:

  • Maaaring maantala ang data nang hanggang 48 oras.
  • Ang account na wala pang 100 follower ay walang follows_and_unfollows o follower_demographics; ang engaged_audience_demographics ay nangangailangan ng 100 engagement sa timeframe.
  • Ang nawawala o hindi available na data ay ibinabalik bilang empty set, hindi bilang 0.
  • Ang demographic metrics ay nagbabalik lamang ng top 45 na value.
  • Ang account metrics ay iniimbak nang hanggang 90 araw, at ang media metrics nang hanggang 2 taon.

Ano ang pagkakaiba para sa Stories at carousels?

Available ang Story metrics sa loob lamang ng 24 na oras, at ang value na mas mababa sa 5 ay nagbabalik ng error code 10, not enough viewers, sa halip na numero. Hindi kasama ang mga reply mula sa mga tao sa Europe at Japan, at ang Story na ginawa ng account doon ay nagpapakita ng 0 reply. Sa Instagram Login, walang story_insights webhook, kaya kailangang basahin ang mga numero ng Story habang aktibo pa ang Story.

Ang carousel ay iniuulat bilang isang post: walang ibinabalik na insights ang Meta para sa mga larawan at video sa loob nito.

Bakit nagbabago ang mga pangalan ng metric?

Dahil inaalis at pinapalitan ng Meta ang mga metric sa pagitan ng API version. Na-deprecate ang impressions para sa v22.0 at tumigil sa paggana sa lahat ng version noong 21 Abril 2025, maliban sa media na ginawa bago ang 2 Hulyo 2024. Ipinakilala ang views bilang kapalit nito, at sabay ding nawala ang plays, clips_replays_count, at ig_reels_aggregated_all_plays_count. Mas maaga namang inalis ang video_views at ilang profile time series, kabilang ang profile_views. Ang hiling na may inalis nang pangalan ay nabibigo, kaya ang listahan ng metric na isinulat para sa mas naunang API version ay maaaring kailangang i-update.

Mga karaniwang pagkakamali

  • Pagre-request ng impressions. Hindi na ito gumagana sa anumang API version; humingi ng views sa halip.
  • Pagtrato sa walang laman na resulta bilang zero. Nagbabalik ang Meta ng walang laman na data set kapag hindi available ang metric, at hindi ito katulad ng walang aktibidad.
  • Pagbasa ng Story metrics pagkatapos matapos ang Story. Available lamang ang mga ito sa loob ng 24 na oras.
  • Pagdagdag ng breakdown sa hiling na may maraming metric. Kapag hindi ito sinusuportahan ng isa sa mga ito, nabibigo ang buong call.
Ginagawa ito gamit ang EasyCoexistence

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

Ano ang pumalit sa impressions sa Instagram API?

views, na nagbibilang ng beses na na-play o naipakita ang content. Inalis ng Meta ang impressions sa lahat ng API version noong 21 Abril 2025, maliban sa media na ginawa bago ang 2 Hulyo 2024.

Bakit walang follower data ang account ko?

Hindi ibinabalik ng Meta ang follows_and_unfollows o follower demographics para sa account na may mas kaunti sa 100 follower.

Gaano kalayo sa nakaraan ko mababasa ang Instagram insights?

Hanggang 90 araw ng account metrics at hanggang 2 taon ng media metrics, na may online_followers na sumasaklaw lamang sa nakaraang 30 araw.

Kasama ba sa mga numero ang ads?

Bahagya. Kasama sa reach at accounts engaged ng account ang ads, habang ang likes, comments, at views ng post ay bilang lamang ng organic activity.

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