Uvid u Instagram Reels preko API-ja
Instagramov endpoint za uvid u medij, GET /<IG_MEDIA_ID>/insights, za Reel vraća ove metrike: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time i reels_skip_rate, a za crossposted Reel još crossposted_views i facebook_views. plays, clips_replays_count i ig_reels_aggregated_all_plays_count ukinute su u aprilu 2025, a umesto njih stoji views.
easyCoexistence čita uvide za Reel preko get_social_insights, pa Claude, ChatGPT ili vaš sopstveni kod mogu da pitaju kako je Reel prošao i dobiju views, reach, vreme gledanja i stopu preskakanja direktno od Mete za povezani nalog, uz Metinu grešku kada je naziv metrike ukinut.
Vremenski prozor koji meri reels_skip_rate: udeo pregleda u kojima je Reel preskočen u prvih 3 sekunde.
Kada su plays, clips_replays_count i ig_reels_aggregated_all_plays_count zastareli u svim verzijama API-ja.
Kada su reels_skip_rate, reposts, crossposted_views i facebook_views dodati u media insights.
Koliko podaci iza metrika medija mogu kasniti.
Koliko dugo Meta čuva metrike medija.
Koje metrike vraća Reel?
Metrike koje Metin referentni pregled media insights navodi za media_product_type REELS, čitane pomoću GET /<IG_MEDIA_ID>/insights i parametra metric sa nazivima razdvojenim zarezom. Meta neke od njih označava kao procenjene ili u razvoju, što je napomenuto pored svake, a lajkove i komentare računa samo kao organsku aktivnost:
Šta vraća zahtev za Reels insights?
Jedan objekat po metrici u data, svaki sa name, period, values, title, description i id. period uvek glasi lifetime: Meta ga postavlja za metrike medija i ne može se menjati, pa zahtev ne treba da ga sadrži. Metin referentni pregled opisuje dve metrike vremena gledanja kao iznose vremena bez navođenja jedinice, zato ih proverite na Reelu koji poznajete pre nego što ih grafički prikažete.
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"
}
]
}Koje metrike Reels su ukinute i čime su zamenjene?
Meta je prve tri označila kao zastarele od Graph API v22.0, 21. januara 2025, na dan kada je uvela views, a u svim verzijama 21. aprila 2025; video_views je zastareo od v21.0 i u svim verzijama 8. januara 2025. Zahtev koji navodi ukinutu metriku ne uspeva, pa listu metrika napisanu pre 2025. treba ažurirati:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Šta na Reelu broje views i reach?
views je broj puta kada je Reel pušten na Instagramu, metrika koju Meta označava kao u razvoju; reach je broj jedinstvenih naloga koji su ga videli bar jednom, što Meta označava kao procenjeno. likes, comments, views i total_interactions broje samo organsku aktivnost, bez angažmana na oglasima napravljenim od Reela. total_likes, total_comments i total_views, koji uključuju promovisane medije, dostupni su samo uz Facebook Login.
Koja ograničenja i kašnjenja važe?
Metin referentni pregled media insights postavlja ova pravila za brojke Reela:
- Podaci iza metrika mogu kasniti do 48 sati.
- Metrike medija čuvaju se do 2 godine.
- Nedostajući ili nedostupni podaci vraćaju prazan skup podataka, a ne 0.
crossposted_viewsifacebook_viewsvraćaju grešku za Reel koji nije bio crossposted, pa ih zahtevajte u zasebnom pozivu.- Razdvajanje koje tražena metrika ne podržava obara ceo zahtev uz poruku An unknown error has occurred.
- Uz Instagram Login token mora imati
instagram_business_basiciinstagram_business_manage_insights, na graph.instagram.com.
Kako get_social_insights čita Reel?
Uz account_id veze, ID medija Reela kao object_id i listu metrika. easyCoexistence poziva GET /<IG_MEDIA_ID>/insights na graph.instagram.com sa tokenom naloga, prosleđuje Meti nazive metrika kako su dati i vraća Metine podatke, ili Metinu grešku kada je neki naziv ukinut. list_social_posts vraća ID-jeve medija nedavnih objava i Reelova naloga.
{
"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"
]
}Česte greške
- Traženje plays ili clips_replays_count. Obe su zastarele u svim verzijama API-ja 21. aprila 2025; tražite views.
- Mešanje crossposted_views ili facebook_views u opšti zahtev. Vraćaju grešku za Reel koji nije bio crossposted, a greška obara poziv.
- Pretpostavka jedinice za vreme gledanja. Meta ne navodi nijednu za ig_reels_avg_watch_time ni ig_reels_video_view_total_time, pa proverite na poznatom Reelu.
- Čitanje praznog rezultata kao nule. Meta vraća prazan skup podataka kada podaci ne postoje ili su trenutno nedostupni.
Od US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, i prvih 3 dana besplatno.
Često postavljana pitanja
Zašto zahtev za Reels insights vraća prazan rezultat?
Meta vraća prazan skup podataka, a ne 0, kada podaci ne postoje ili su trenutno nedostupni, a podaci iza metrika mogu kasniti do 48 sati.
Kako da dobijem vreme gledanja Reelsa preko API-ja?
Zatražite ig_reels_avg_watch_time za prosek i ig_reels_video_view_total_time za ukupno vreme, uključujući ponovna gledanja, iz GET /<IG_MEDIA_ID>/insights.
Šta je reels_skip_rate?
Procenat početnih pregleda u kojima je Reel preskočen u prvih 3 sekunde. Meta ga je dodala 3. decembra 2025. i označava kao procenjenu i u razvoju metriku.
Da li Reels insights uključuju preglede oglasa?
Ne. likes, comments, views i total_interactions broje samo organsku aktivnost; total_views, koji uključuje promovisane medije, dostupan je samo uz Facebook Login.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na