IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Takwimu za Instagram Reels kupitia API

Endpoint ya vipimo vya media ya Instagram, GET /<IG_MEDIA_ID>/insights, inarudisha vipimo hivi kwa Reel: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time na reels_skip_rate, pamoja na crossposted_views na facebook_views kwa Reel iliyochapishwa mtambuka. plays, clips_replays_count na ig_reels_aggregated_all_plays_count viliondolewa Aprili 2025, na views zikachukua nafasi yake.

easyCoexistence husoma vipimo vya Reel kwa get_social_insights, ili Claude, ChatGPT au msimbo wako mwenyewe waweze kuuliza Reel ilifanya vipi na kupata views, reach, muda wa kutazama na kiwango cha kuruka moja kwa moja kutoka Meta kwa akaunti iliyounganishwa, pamoja na hitilafu ya Meta pale jina la kipimo linapoondolewa.

3 seconds

Dirisha ambalo reels_skip_rate hupima: sehemu ya views zilizoruka Reel ndani ya sekunde 3 za kwanza.

21 Apr 2025

Wakati plays, clips_replays_count na ig_reels_aggregated_all_plays_count zilipositishwa katika kila toleo la API.

3 Dec 2025

Wakati reels_skip_rate, reposts, crossposted_views na facebook_views viliongezwa kwenye media insights.

48 hours

Muda ambao data nyuma ya vipimo vya media inaweza kuchelewa.

2 years

Muda ambao Meta huhifadhi vipimo vya media.

Ni vipimo gani Reel hurudisha?

Ni vile vilivyoorodheshwa na rejeleo la vipimo vya media vya Meta kwa media_product_type REELS, vinavyosomwa kwa GET /<IG_MEDIA_ID>/insights na parameta ya vipimo iliyotenganishwa kwa koma. Meta huweka alama ya makadirio au bado vinaendelezwa kwa baadhi yake, kama inavyoonyeshwa kando ya kila kimoja, na huhesabu likes na comments kama shughuli za asili pekee:

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.

Ombi la vipimo vya Reels hurudisha nini?

Kitu kimoja kwa kila kipimo ndani ya data, chenye name, period, values, title, description na id. period husomeka daima lifetime: Meta huiweka kwa vipimo vya media na haiwezi kubadilishwa, kwa hiyo ombi halihitaji chochote. Rejeleo la Meta linaeleza vipimo viwili vya muda wa kutazama kama kiasi cha muda bila kutaja kitengo, kwa hiyo vilinganishe na Reel unayoijua kabla ya kuvichora kwenye chati.

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

Ni vipimo gani vya Reels viliondolewa, na nini kiliviweka mahali pake?

Meta iliondoa vitatu vya kwanza kuanzia Graph API v22.0 tarehe 21 Januari 2025, siku ile ile ilipoanzisha views, na katika kila toleo tarehe 21 Aprili 2025; video_views iliondolewa kuanzia v21.0 na katika kila toleo tarehe 8 Januari 2025. Ombi linalotaja kipimo kilichoondolewa linashindwa, kwa hiyo orodha ya vipimo iliyoandikwa kabla ya 2025 inahitaji kusasishwa:

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

Views na reach huhesabu nini kwenye Reel?

views ni idadi ya mara Reel ilichezwa kwenye Instagram, kipimo ambacho Meta kinakiweka alama ya bado kinaendelezwa; reach ni idadi ya akaunti za kipekee zilizoiona angalau mara moja, ambayo Meta inaiweka alama ya makadirio. likes, comments, views na total_interactions huhesabu shughuli za asili pekee, bila kujumuisha ushiriki kwenye matangazo yaliyotengenezwa kutoka kwenye Reel. total_likes, total_comments na total_views, vinavyojumuisha media iliyotangazwa, vinapatikana kwa Facebook Login pekee.

Ni mipaka na ucheleweshaji gani unatumika?

Rejeleo la vipimo vya media vya Meta linaweka kanuni hizi kwa namba za Reel:

  • Data nyuma ya vipimo inaweza kuchelewa hadi saa 48.
  • Vipimo vya media huhifadhiwa hadi miaka 2.
  • Data inayokosekana au isiyopatikana hurudisha seti tupu ya data, si 0.
  • crossposted_views na facebook_views hutoa hitilafu kwa Reel ambayo haikuchapishwa mtambuka, kwa hiyo yaombe katika ombi lake la pekee.
  • Mgawanyo ambao kipimo kilichoombwa hakiuungi mkono unashindwa ombi lote kwa ujumbe An unknown error has occurred.
  • Kwa Instagram Login tokeni inahitaji instagram_business_basic na instagram_business_manage_insights, kwenye graph.instagram.com.

get_social_insights inasomaje Reel?

Kwa account_id ya muunganisho, media ID ya Reel kama object_id na orodha ya vipimo. easyCoexistence huita GET /<IG_MEDIA_ID>/insights kwenye graph.instagram.com kwa tokeni ya akaunti, hupeleka majina ya vipimo kwa Meta kama yalivyo, na kurudisha data ya Meta, au hitilafu yake yenyewe pale jina la kipimo lililoondolewa linapotajwa. list_social_posts hurudisha media IDs za machapisho na Reels za hivi karibuni za akaunti.

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

Makosa ya kawaida

  • Kuomba plays au clips_replays_count. Vyote viwili viliondolewa katika kila toleo la API tarehe 21 Aprili 2025; omba views.
  • Kuchanganya crossposted_views au facebook_views kwenye ombi la jumla. Hutoa hitilafu kwa Reel ambayo haikuchapishwa mtambuka, na hitilafu hiyo inashindwa wito mzima.
  • Kudhani kitengo cha muda wa kutazama. Rejeleo la Meta halitaji kitengo chochote kwa ig_reels_avg_watch_time wala ig_reels_video_view_total_time, kwa hiyo linganisha na Reel unayoijua.
  • Kusoma matokeo tupu kama sifuri. Meta hurudisha seti tupu ya data pale data isipokuwepo au isipopatikana kwa sasa.
Kufanya hili ukitumia EasyCoexistence

Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, kadri unavyoongeza muunganisho, na siku 3 za kwanza ni bure.

Maswali yanayoulizwa mara kwa mara

Kwa nini ombi la vipimo vya Reels hurudisha matokeo tupu?

Meta hurudisha seti tupu ya data, si 0, pale data isipokuwepo au isipopatikana kwa sasa, na data nyuma ya vipimo inaweza kuchelewa hadi saa 48.

Ninapataje muda wa kutazama wa Reels kutoka API?

Omba ig_reels_avg_watch_time kwa wastani na ig_reels_video_view_total_time kwa jumla, ikijumuisha replays, kutoka GET /<IG_MEDIA_ID>/insights.

reels_skip_rate ni nini?

Ni asilimia ya views za awali zilizoruka Reel ndani ya sekunde 3 za kwanza. Meta iliiongeza tarehe 3 Desemba 2025 na inaiweka alama ya makadirio na bado inaendelezwa.

Je, vipimo vya Reels vinajumuisha views za matangazo?

Hapana. likes, comments, views na total_interactions huhesabu shughuli za asili pekee; total_views, inayojumuisha media iliyotangazwa, inapatikana kwa Facebook Login pekee.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye