Insight di Instagram Reels tramite l'API
L'endpoint di insight dei contenuti multimediali di Instagram, GET /<IG_MEDIA_ID>/insights, restituisce per un Reel queste metriche: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate, più crossposted_views e facebook_views per un Reel ripubblicato. plays, clips_replays_count e ig_reels_aggregated_all_plays_count sono stati ritirati nell'aprile 2025 e sostituiti da views.
easyCoexistence legge gli insight di un Reel con get_social_insights, così Claude, ChatGPT o il tuo codice possono chiedere come è andato un Reel e ottenere visualizzazioni, copertura, tempo di visione e tasso di salto direttamente da Meta per l'account collegato, con l'errore di Meta quando un nome di metrica è ritirato.
Intervallo misurato da reels_skip_rate: la quota di visualizzazioni in cui il Reel è stato saltato entro i primi 3 secondi.
Quando plays, clips_replays_count e ig_reels_aggregated_all_plays_count sono stati deprecati in ogni versione dell'API.
Quando reels_skip_rate, reposts, crossposted_views e facebook_views sono stati aggiunti agli insight dei contenuti multimediali.
Di quanto possono essere ritardati i dati alla base delle metriche dei contenuti multimediali.
Per quanto tempo Meta conserva le metriche dei contenuti multimediali.
Quali metriche restituisce un Reel?
Quelle elencate dal riferimento di Meta per gli insight dei contenuti multimediali con media_product_type REELS, lette con GET /<IG_MEDIA_ID>/insights e un parametro metric con i nomi separati da virgola. Meta segnala alcune come stimate o in sviluppo, come indicato accanto a ciascuna, e conteggia like e commenti solo come attività organica:
Cosa restituisce una richiesta di insight per i Reels?
Un oggetto per ogni metrica in data, ciascuno con name, period, values, title, description e id. period è sempre lifetime: lo imposta Meta per le metriche dei contenuti multimediali e non può essere modificato, quindi la richiesta non ne ha bisogno. Il riferimento di Meta descrive le due metriche del tempo di visione come quantità di tempo senza indicarne l'unità, quindi verificale su un Reel noto prima di usarle in un grafico.
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"
}
]
}Quali metriche dei Reels sono state ritirate, e con cosa sono state sostituite?
Meta ha deprecato le prime tre dalla Graph API v22.0 il 21 gennaio 2025, lo stesso giorno in cui ha introdotto views, e in ogni versione il 21 aprile 2025; video_views è stata deprecata dalla v21.0 e in ogni versione dall'8 gennaio 2025. Una richiesta che nomina una metrica ritirata fallisce, quindi un elenco di metriche scritto prima del 2025 va aggiornato:
| 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 |
Cosa contano visualizzazioni e copertura di un Reel?
views è il numero di volte in cui il Reel è stato riprodotto su Instagram, una metrica che Meta segnala in sviluppo; reach è il numero di account unici che l'hanno visto almeno una volta, che Meta segnala come stimato. likes, comments, views e total_interactions contano solo l'attività organica, escludendo le interazioni sugli annunci creati dal Reel. total_likes, total_comments e total_views, che includono i contenuti promossi, sono disponibili solo con Facebook Login.
Quali limiti e ritardi si applicano?
Il riferimento di Meta sugli insight dei contenuti multimediali stabilisce queste regole per i numeri di un Reel:
- I dati alla base delle metriche possono essere ritardati fino a 48 ore.
- Le metriche dei contenuti multimediali sono conservate fino a 2 anni.
- Dati mancanti o non disponibili restituiscono un dataset vuoto, non 0.
crossposted_viewsefacebook_viewsgenerano un errore per un Reel non ripubblicato, quindi richiedili in una chiamata a sé.- Una suddivisione non supportata da una metrica richiesta fa fallire l'intera richiesta con An unknown error has occurred.
- Con Instagram Login il token richiede
instagram_business_basiceinstagram_business_manage_insights, su graph.instagram.com.
Come legge un Reel get_social_insights?
Con l'account_id della connessione, l'ID del contenuto multimediale del Reel come object_id e un elenco di metriche. easyCoexistence chiama GET /<IG_MEDIA_ID>/insights su graph.instagram.com con il token dell'account, passa a Meta i nomi delle metriche così come sono e restituisce i dati di Meta, oppure l'errore di Meta quando un nome è ritirato. list_social_posts restituisce gli ID dei contenuti multimediali dei post e dei Reels recenti dell'account.
{
"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"
]
}Errori comuni
- Richiedere plays o clips_replays_count. Entrambe sono state deprecate in ogni versione dell'API il 21 aprile 2025; chiedi views.
- Inserire crossposted_views o facebook_views in una richiesta generica. Generano un errore per un Reel non ripubblicato, e l'errore fa fallire la chiamata.
- Presumere un'unità per il tempo di visione. Il riferimento di Meta non ne indica una per ig_reels_avg_watch_time o ig_reels_video_view_total_time, quindi verifica su un Reel noto.
- Leggere un risultato vuoto come zero. Meta restituisce un dataset vuoto quando i dati non esistono o al momento non sono disponibili.
Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e la prova gratuita di 3 giorni.
Domande frequenti
Perché una richiesta di insight dei Reels restituisce un risultato vuoto?
Meta restituisce un dataset vuoto, non 0, quando i dati non esistono o al momento non sono disponibili, e i dati alla base delle metriche possono accusare un ritardo fino a 48 ore.
Come ottengo il tempo di visione dei Reels dall'API?
Richiedi ig_reels_avg_watch_time per la media e ig_reels_video_view_total_time per il totale, riproduzioni ripetute incluse, da GET /<IG_MEDIA_ID>/insights.
Cos'è reels_skip_rate?
La percentuale delle visualizzazioni iniziali in cui il Reel è stato saltato entro i primi 3 secondi. Meta l'ha aggiunta il 3 dicembre 2025 e la segnala come stimata e in sviluppo.
Gli insight dei Reels includono le visualizzazioni degli annunci?
No. likes, comments, views e total_interactions contano solo l'attività organica; total_views, che include i contenuti promossi, è disponibile solo con Facebook Login.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il