AccediInizia la prova gratuita
easyCoexistence API ufficiali

Reel e insight video di Facebook tramite l'API

Gli insight video e Reel di Facebook arrivano da GET /{video-id}/video_insights: total_video_views conta le riproduzioni di almeno 3 secondi, total_video_avg_time_watched e total_video_view_total_time danno il tempo di visualizzazione in millisecondi, e i Reel aggiungono blue_reels_play_count, fb_reels_total_plays e fb_reels_replay_count. A giugno 2026 Meta ha dismesso, per tutte le versioni dell'API, le metriche di impression e di visualizzatori unici dei video, come total_video_impressions.

easyCoexistence legge gli insight di Pagina e dei post di Facebook con get_social_insights da Claude, ChatGPT o dal tuo codice, così la tua AI può dire come stanno andando la Pagina e i suoi post; i video_insights propri di un video o di un Reel si leggono in Meta Business Suite.

3 seconds

La riproduzione più breve che total_video_views conta, o quasi l'intera durata per i video più brevi di quella.

June 2026

Quando Meta ha dismesso total_video_impressions, total_video_views_unique e post_video_views_unique per tutte le versioni dell'API.

2 years

Per quanto indietro sono disponibili i dati degli insight video.

40 intervals

Come total_video_retention_graph divide un video, riportando le riproduzioni a ogni punto come percentuale di tutte le visualizzazioni.

1 ms

La riproduzione che conta come Reel in blue_reels_play_count, escluse le riproduzioni ripetute.

Reels left out

Le interazioni sui Reel non sono incluse nelle metriche della Pagina, tra i limiti indicati nel riferimento degli insight di Meta.

Quali metriche restituisce video_insights per un video?

Queste metriche video sono nel riferimento di Meta e fuori dalle sue liste di dismissione a novembre 2026, tutte totali cumulativi letti sull'ID del video. Le visualizzazioni non includono il tempo passato a rivedere una riproduzione, e diverse hanno una versione organica e una a pagamento, come total_video_views_organic e total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

Quali metriche riguardano i Reel?

Il riferimento di Meta ha una sezione sui Reel, da leggere sull'ID video del Reel, con valori cumulativi:

  • blue_reels_play_count: riproduzioni di almeno 1 millisecondo dopo che un'impression viene conteggiata, escluse le riproduzioni ripetute.
  • fb_reels_total_plays: le stesse riproduzioni incluse quelle ripetute; fb_reels_replay_count: solo le riproduzioni ripetute nella stessa sessione.
  • post_video_avg_time_watched e post_video_view_time: media e totale dei millisecondi riprodotti, incluse le riproduzioni ripetute.
  • post_video_followers: i follow dal Reel.
  • post_video_likes_by_reaction_type: i like sul Reel.
  • post_video_social_actions: i suoi commenti e condivisioni.
  • post_video_retention_graph: riproduzioni in punti del Reel, come percentuale delle riproduzioni totali.

Quali metriche video Meta ha dismesso nel 2026?

L'annuncio dell'API Graph v25 di Meta ha dismesso due gruppi a giugno 2026, per tutte le versioni dell'API, e indirizza verso le sue metriche Media Views e Media Viewers: post_total_media_view_unique e page_total_media_view_unique per i visualizzatori unici, e post_media_view e page_media_view per la suddivisione tra a pagamento e organica.

  • Impression dei video: total_video_impressions con le sue varianti unique, paid, organic, viral e fan, e post_impressions_unique su un video.
  • Visualizzatori dei 3 secondi: total_video_views_unique e le sue versioni organiche e a pagamento, post_video_views_unique e le sue versioni organiche e a pagamento, e page_video_views_unique.

post_video_views e page_video_views sono ancora validi?

Sì. Entrambe restano nel riferimento degli insight di Meta senza contrassegno di dismissione: post_video_views conta le riproduzioni di almeno 3 secondi di un post video, per totale cumulativo o per giorno, e page_video_views conta quelle della Pagina, per giorno, settimana o days_28. Le loro versioni unique, post_video_views_unique e page_video_views_unique, sono state dismesse a giugno 2026 per tutte le versioni dell'API, e le metriche a 10 secondi, come post_video_views_10s, sopra la v18.

Come si richiedono gli insight video?

Su tre oggetti, ciascuno con le proprie metriche. GET /{video-id}/video_insights con il parametro metric impostato a un elenco separato da virgole legge un video o un Reel, e senza metric restituisce i totali del video. Le metriche video a livello di post, come post_video_views, si leggono con GET /{page-post-id}/insights, e quelle a livello di Pagina, come page_video_views, con GET /{page-id}/insights e un period.

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

Quali permessi e attività servono?

Un token della Pagina di qualcuno che può eseguire l'attività ANALYZE sulla Pagina. Il riferimento di Meta su video_insights indica read_insights e pages_manage_engagement, mentre la sua guida agli insight video indica pages_read_engagement. I dati coprono gli ultimi 2 anni, gli insight dei video su utenti o gruppi non sono disponibili, e un video condiviso in crosspost ha un ID video separato per ciascuna Pagina su cui è stato pubblicato.

Le metriche a livello di Pagina includono i Reel?

No. Il riferimento degli insight di Meta elenca, tra i suoi limiti per la lettura delle metriche di Pagina, che le interazioni sui Reel non sono incluse. Riproduzioni, follow, commenti e condivisioni di un Reel si leggono sul Reel stesso, tramite video_insights con il suo ID video.

Come le legge easyCoexistence?

get_social_insights legge l'edge degli insight della Pagina o di un singolo post: il parametro metric, un period e object_id per un post, con parametri aggiuntivi come since e until passati senza modifiche. video_insights è un edge a sé, che nessuno strumento legge, quindi le metriche proprie di un video o di un Reel si leggono in Meta Business Suite. Una metrica ritirata torna come errore di Meta, così la tua AI può cambiare nome.

Errori comuni

  • Richiedere total_video_impressions. Meta ha dismesso le metriche di impression dei video a giugno 2026; chiedi invece le sue metriche Media Views, come post_media_view.
  • Sommare i valori del grafico di permanenza. Sono percentuali delle visualizzazioni a ogni intervallo, non conteggi di riproduzioni.
  • Cercare i Reel nei totali della Pagina. Gli insight di Pagina di Meta escludono le interazioni sui Reel, quindi leggi il video_insights di ogni Reel.
  • Leggere il tempo di visualizzazione in secondi. total_video_avg_time_watched, total_video_view_total_time e post_video_view_time sono in millisecondi.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo in calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Cosa ha sostituito total_video_views_unique?

Meta indirizza verso le sue metriche Media Viewers: post_total_media_view_unique sul post, e page_total_media_view_unique per la Pagina.

Come ottengo le riproduzioni di un Reel tramite l'API?

Leggi blue_reels_play_count, oppure fb_reels_total_plays per includere le riproduzioni ripetute, da GET /{video-id}/video_insights con l'ID video restituito dalla chiamata di avvio del Reel.

post_impressions_unique funziona ancora per i Reel?

No. La tabella dei Reel di Meta lo elenca ancora, ma l'annuncio v25 lo ha dismesso su video_insights a giugno 2026; post_total_media_view_unique conta i visualizzatori unici sul post.

Quali video non hanno insight?

I video pubblicati su utenti o gruppi. Gli insight video di Meta coprono i video sulle Pagine, con dati degli ultimi 2 anni.

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