AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

3 seconds

Intervallo misurato da reels_skip_rate: la quota di visualizzazioni in cui il Reel è stato saltato entro i primi 3 secondi.

21 Apr 2025

Quando plays, clips_replays_count e ig_reels_aggregated_all_plays_count sono stati deprecati in ogni versione dell'API.

3 Dec 2025

Quando reels_skip_rate, reposts, crossposted_views e facebook_views sono stati aggiunti agli insight dei contenuti multimediali.

48 hours

Di quanto possono essere ritardati i dati alla base delle metriche dei contenuti multimediali.

2 years

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:

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.

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.

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

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:

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

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_views e facebook_views generano 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_basic e instagram_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.

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

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.
Farlo con EasyCoexistence

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