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.
Fereastra măsurată de reels_skip_rate: ponderea vizualizărilor în care Reel-ul a fost sărit în primele 3 secunde.
Când au fost deprecate plays, clips_replays_count și ig_reels_aggregated_all_plays_count în fiecare versiune de API.
Când au fost adăugate reels_skip_rate, reposts, crossposted_views și facebook_views în statisticile media.
Cât de mult pot întârzia datele din spatele metricilor media.
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ă:
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.
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ă:
| 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 |
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șifacebook_viewsdau 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șiinstagram_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.
{
"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.
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