Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Statistici Instagram Reels prin API

Endpoint-ul de statistici media al Instagram, GET /<IG_MEDIA_ID>/insights, returnează pentru un Reel aceste metrici: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time și reels_skip_rate, plus crossposted_views și facebook_views pentru un Reel distribuit încrucișat. plays, clips_replays_count și ig_reels_aggregated_all_plays_count au fost retrase în aprilie 2025, locul lor fiind luat de views.

easyCoexistence citește statisticile unui Reel cu get_social_insights, astfel încât Claude, ChatGPT sau propriul cod pot întreba cum a performat un Reel și primesc views, reach, timpul de vizionare și rata de sărire direct de la Meta, pentru contul conectat, cu eroarea proprie a Meta atunci când un nume de metrică este retras.

3 seconds

Fereastra măsurată de reels_skip_rate: ponderea vizualizărilor în care Reel-ul a fost sărit în primele 3 secunde.

21 Apr 2025

Când au fost deprecate plays, clips_replays_count și ig_reels_aggregated_all_plays_count în fiecare versiune de API.

3 Dec 2025

Când au fost adăugate reels_skip_rate, reposts, crossposted_views și facebook_views în statisticile media.

48 hours

Cât de mult pot întârzia datele din spatele metricilor media.

2 years

Cât timp stochează Meta metricile media.

Ce metrici returnează un Reel?

Cele din referința Meta pentru statisticile media cu media_product_type REELS, citite cu GET /<IG_MEDIA_ID>/insights și un parametru metric cu valori separate prin virgulă. Meta marchează unele ca estimate sau în dezvoltare, notat lângă fiecare, și numără aprecierile și comentariile doar ca activitate organică:

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.

Ce returnează o cerere de statistici pentru Reels?

Un obiect pentru fiecare metrică din data, cu name, period, values, title, description și id. period are întotdeauna valoarea lifetime: Meta o setează pentru metricile media și nu poate fi schimbată, deci cererea nu are nevoie de ea. Referința Meta descrie cele două metrici de timp de vizionare ca durate fără a numi o unitate, așa că verificați-le pe un Reel cunoscut înainte de a le reprezenta grafic.

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

Ce metrici ale Reels au fost retrase și ce le-a înlocuit?

Meta a deprecat primele trei din Graph API v22.0 pe 21 ianuarie 2025, ziua în care a introdus views, iar în fiecare versiune pe 21 aprilie 2025; video_views a fost deprecat din v21.0 și în fiecare versiune pe 8 ianuarie 2025. O cerere care numește o metrică retrasă eșuează, așa că o listă de metrici scrisă înainte de 2025 trebuie actualizată:

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

Ce numără views și reach pe un Reel?

views este numărul de ori în care Reel-ul a fost redat pe Instagram, metrică pe care Meta o marchează în dezvoltare; reach este numărul de conturi unice care l-au văzut cel puțin o dată, pe care Meta îl marchează estimat. likes, comments, views și total_interactions numără doar activitatea organică, fără interacțiunile cu anunțurile făcute din Reel. total_likes, total_comments și total_views, care includ conținutul promovat, sunt oferite doar cu Facebook Login.

Ce limite și întârzieri se aplică?

Referința Meta pentru statisticile media stabilește aceste reguli pentru cifrele unui Reel:

  • Datele din spatele metricilor pot întârzia până la 48 de ore.
  • Metricile media sunt stocate până la 2 ani.
  • Datele lipsă sau indisponibile returnează un set de date gol, nu 0.
  • crossposted_views și facebook_views dau eroare pentru un Reel care nu a fost distribuit încrucișat, așa că cereți-le într-un apel separat.
  • O defalcare pe care o metrică cerută nu o acceptă eșuează întreaga cerere cu mesajul „A apărut o eroare necunoscută”.
  • Cu Instagram Login, token-ul trebuie să aibă instagram_business_basic și instagram_business_manage_insights, pe graph.instagram.com.

Cum citește get_social_insights un Reel?

Cu account_id al conexiunii, ID-ul media al Reel-ului ca object_id și o listă de metrici. easyCoexistence apelează GET /<IG_MEDIA_ID>/insights pe graph.instagram.com cu token-ul contului, transmite numele metricilor către Meta așa cum sunt date și returnează datele Meta sau eroarea proprie a Meta atunci când un nume este retras. list_social_posts returnează ID-urile media ale postărilor și Reel-urilor recente ale contului.

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

Greșeli frecvente

  • Cererea de plays sau clips_replays_count. Ambele au fost deprecate în fiecare versiune de API pe 21 aprilie 2025; cereți views.
  • Amestecarea crossposted_views sau facebook_views într-o cerere generală. Dau eroare pentru un Reel care nu a fost distribuit încrucișat, iar eroarea eșuează apelul.
  • Presupunerea unei unități pentru timpul de vizionare. Referința Meta nu numește niciuna pentru ig_reels_avg_watch_time sau ig_reels_video_view_total_time, așa că verificați pe un Reel cunoscut.
  • Citirea unui rezultat gol ca zero. Meta returnează un set de date gol când datele nu există sau sunt momentan indisponibile.
Faceți acest lucru cu EasyCoexistence

US$ 9 până la US$ 0,75 pe conexiune și pe lună, cu scădere pe măsură ce adăugați conexiuni, cu perioada de probă gratuită de 3 zile.

Întrebări frecvente

De ce returnează o cerere de statistici Reels un rezultat gol?

Meta returnează un set de date gol, nu 0, când datele nu există sau sunt momentan indisponibile, iar datele din spatele metricilor pot întârzia până la 48 de ore.

Cum obțin timpul de vizionare Reels din API?

Cereți ig_reels_avg_watch_time pentru medie și ig_reels_video_view_total_time pentru total, inclusiv reluările, din GET /<IG_MEDIA_ID>/insights.

Ce este reels_skip_rate?

Procentul vizualizărilor inițiale în care Reel-ul a fost sărit în primele 3 secunde. Meta l-a adăugat pe 3 decembrie 2025 și îl marchează estimat și în dezvoltare.

Statisticile Reels includ vizualizările din anunțuri?

Nu. likes, comments, views și total_interactions numără doar activitatea organică; total_views, care include conținutul promovat, este oferit doar cu Facebook Login.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la