Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Uvidi u Instagram Reels putem API-ja

Instagramov endpoint za uvide u medije, 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 Reel objavljen unakrsno i crossposted_views te facebook_views. Metrike plays, clips_replays_count i ig_reels_aggregated_all_plays_count ukinute su u travnju 2025., a umjesto njih dolazi views.

easyCoexistence čita uvide u Reel pomoću get_social_insights, pa Claude, ChatGPT ili vaš vlastiti kod mogu pitati kako je Reel prošao i dobiti prikaze, doseg, vrijeme gledanja i stopu preskakanja izravno od Mete za povezani račun, uz Metinu vlastitu pogrešku kad je naziv metrike ukinut.

3 seconds

Vremenski prozor koji mjeri reels_skip_rate: udio prikaza u kojima je Reel preskočen unutar prve 3 sekunde.

21 Apr 2025

Kada su plays, clips_replays_count i ig_reels_aggregated_all_plays_count ukinute u svim verzijama API-ja.

3 Dec 2025

Kada su reels_skip_rate, reposts, crossposted_views i facebook_views dodani u uvide u medije.

48 hours

Koliko podaci iza metrika medija mogu kasniti.

2 years

Koliko dugo Meta pohranjuje metrike medija.

Koje metrike vraća Reel?

Metrike koje navodi Metin referentni popis uvida u medije za media_product_type REELS, a čitaju se pomoću GET /<IG_MEDIA_ID>/insights i parametra metric s popisom metrika odvojenih zarezom. Meta neke od njih označava kao procijenjene ili u razvoju, što je naznačeno uz svaku, a lajkove i komentare računa samo kao organsku aktivnost:

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.

Što vraća zahtjev za uvide u Reels?

Po jedan objekt za svaku metriku u polju data, svaki s poljima name, period, values, title, description i id. period uvijek glasi lifetime: Meta ga postavlja za metrike medija i ne može se mijenjati, pa zahtjev ne treba nikakav. Metin referentni opis dvije metrike vremena gledanja navodi kao iznose vremena bez mjerne jedinice, pa ih prije prikazivanja na grafikonu provjerite na Reelu koji poznajete.

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

Koje su metrike Reelsa ukinute i čime su zamijenjene?

Meta je prve tri ukinula od Graph API v22.0 21. siječnja 2025., dana kad je uvela views, a u svim verzijama 21. travnja 2025.; video_views je ukinut od v21.0 i u svim verzijama 8. siječnja 2025. Zahtjev koji navodi ukinutu metriku ne uspijeva, pa popis metrika napisan prije 2025. treba ažurirati:

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

Što views i reach broje na Reelu?

views je broj puta kad je Reel reproduciran na Instagramu, metrika koju Meta označava kao u razvoju; reach je broj jedinstvenih računa koji su ga vidjeli barem jednom, što Meta označava kao procijenjeno. likes, comments, views i total_interactions broje samo organsku aktivnost, bez angažmana na oglasima napravljenima od Reela. total_likes, total_comments i total_views, koji uključuju promovirane medije, dostupni su samo uz Facebook Login.

Koja ograničenja i kašnjenja vrijede?

Metin referentni opis uvida u medije postavlja ova pravila za brojke Reelsa:

  • Podaci iza metrika mogu kasniti do 48 sati.
  • Metrike medija pohranjuju se do 2 godine.
  • Nedostajući ili nedostupni podaci vraćaju prazan skup podataka, a ne 0.
  • crossposted_views i facebook_views vraćaju pogrešku za Reel koji nije objavljen unakrsno, pa ih zatražite u zasebnom pozivu.
  • Raščlamba koju zatražena metrika ne podržava obara cijeli zahtjev uz pogrešku An unknown error has occurred.
  • Uz Instagram Login token mora imati instagram_business_basic i instagram_business_manage_insights, na graph.instagram.com.

Kako get_social_insights čita Reel?

Uz account_id veze, ID medija Reela kao object_id i popis metrika. easyCoexistence poziva GET /<IG_MEDIA_ID>/insights na graph.instagram.com s tokenom računa, prosljeđuje Meti nazive metrika onakvima kakvi su zadani i vraća Metine podatke ili Metinu vlastitu pogrešku kad je naziv ukinut. list_social_posts vraća ID-jeve medija nedavnih objava i Reelsa računa.

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

Uobičajene pogreške

  • Traženje plays ili clips_replays_count. Obje su ukinute u svim verzijama API-ja 21. travnja 2025.; zatražite views.
  • Miješanje crossposted_views ili facebook_views u opći zahtjev. One vraćaju pogrešku za Reel koji nije objavljen unakrsno, a greška obara poziv.
  • Pretpostavka jedinice za vrijeme gledanja. Meta ne navodi nijednu za ig_reels_avg_watch_time ni ig_reels_video_view_total_time, pa provjerite na poznatom Reelu.
  • Tumačenje praznog rezultata kao nule. Meta vraća prazan skup podataka kad podaci ne postoje ili su trenutno nedostupni.
Radite ovo uz EasyCoexistence

US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s prva 3 dana besplatno.

Često postavljana pitanja

Zašto zahtjev za uvide u Reels vraća prazan rezultat?

Meta vraća prazan skup podataka, a ne 0, kad podaci ne postoje ili su trenutno nedostupni, a podaci iza metrika mogu kasniti do 48 sati.

Kako dobiti vrijeme gledanja Reelsa putem API-ja?

Zatražite ig_reels_avg_watch_time za prosjek i ig_reels_video_view_total_time za ukupno, uključujući ponovna gledanja, iz GET /<IG_MEDIA_ID>/insights.

Što je reels_skip_rate?

Postotak početnih prikaza u kojima je Reel preskočen unutar prve 3 sekunde. Meta ga je dodala 3. prosinca 2025. i označava kao procijenjenu i u razvoju.

Uključuju li uvidi u Reels prikaze oglasa?

Ne. likes, comments, views i total_interactions broje samo organsku aktivnost; total_views, koji uključuje promovirane medije, dostupan je samo uz Facebook Login.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na