AccediInizia la prova gratuita
easyCoexistence API ufficiali

Insights di Instagram tramite l'API: metriche di account e post

L'API di Instagram restituisce gli insights di un account professionale e di ciascuno dei suoi post, Reel e Storie. Le metriche dell'account includono reach, views, account coinvolti, follow e unfollow, like, commenti, salvataggi e condivisioni; le metriche dei post includono reach, views, like, commenti, salvataggi e condivisioni. Meta segnala che i dati possono ritardare fino a 48 ore.

easyCoexistence legge gli insights di Instagram con get_social_insights, quindi puoi chiedere a Claude o ChatGPT come sono andati i post della settimana scorsa e ottenere reach, views, like, commenti, salvataggi e condivisioni direttamente da Meta, per l'account o per un singolo post.

48 hours

Per quanto tempo i dati dietro le metriche di Instagram possono ritardare.

100 followers

Sotto questa soglia, follow e unfollow e dati demografici dei follower non vengono restituiti per l'account.

2 years

Per quanto tempo Meta conserva le metriche dei media.

24 hours

Per quanto tempo le metriche delle Storie restano disponibili tramite l'API.

21 Apr 2025

Quando impressions ha smesso di funzionare in tutte le versioni dell'API, tranne che sui media creati prima del 2 luglio 2024; views lo ha sostituito.

Quali metriche dell'account sono disponibili?

Si leggono con GET /<IG_ID>/insights, soprattutto con period=day e metric_type=total_value:

  • reach: account unici che hanno visto il contenuto, inclusi gli annunci; stimata.
  • views: numero di volte in cui il contenuto è stato riprodotto o visualizzato.
  • accounts_engaged: account che hanno interagito con il contenuto, inclusi gli annunci; stimato.
  • follows_and_unfollows: follow e unfollow nel periodo; richiede almeno 100 follower.
  • likes, comments, saves, shares, replies e reposts, più total_interactions.
  • profile_links_taps: tap sui pulsanti indirizzo, chiamata, email e messaggio dell'azienda.
  • follower_demographics e engaged_audience_demographics: età, città, paese e genere.

Quali metriche dei post sono disponibili?

Si leggono con GET /<IG_MEDIA_ID>/insights; quali metriche si applicano dipende dal formato. Su un post o un Reel, like, commenti, views e total_interactions contano solo l'attività organica, non il coinvolgimento generato dagli annunci creati a partire da questi.

  • Post e Reel: reach, views, like, commenti, saved, shares, total_interactions e reposts.
  • Solo Reel: ig_reels_avg_watch_time, ig_reels_video_view_total_time e reels_skip_rate.
  • Post e Storie: follows, profile_visits e profile_activity.
  • Storie: reach, views, shares, replies, navigation, reposts e total_interactions.

Come funzionano period, metric_type e le suddivisioni?

Le metriche dell'account richiedono period=day. metric_type=total_value restituisce un solo valore per l'intervallo ed è quello richiesto dalle suddivisioni; time_series restituisce un valore al giorno ed è disponibile per reach. Le suddivisioni scompongono un totale per media_product_type (post, carosello, Reel, Storie e annunci), per follow_type (follower o no) oppure per contact_button_type.

Le metriche demografiche richiedono un timeframe come this_week o this_month al posto di since e until; senza since e until, le altre metriche considerano le ultime 24 ore. Chiedere una suddivisione che una delle metriche richieste non supporta fa fallire l'intera richiesta con un errore sconosciuto.

Quali soglie e ritardi si applicano?

Le regole di Meta su quando un dato compare e per quanto tempo resta disponibile:

  • I dati possono ritardare fino a 48 ore.
  • Gli account con meno di 100 follower non ricevono follows_and_unfollows né follower_demographics; engaged_audience_demographics richiede 100 interazioni nel timeframe.
  • I dati mancanti o non disponibili arrivano come insieme vuoto, non come 0.
  • Le metriche demografiche restituiscono solo i primi 45 valori.
  • Le metriche dell'account sono conservate fino a 90 giorni, quelle dei media fino a 2 anni.

Cosa cambia per Storie e caroselli?

Le metriche delle Storie sono disponibili solo per 24 ore, e un valore inferiore a 5 restituisce il codice di errore 10, not enough viewers, invece di un numero. Le risposte di persone in Europa e Giappone non vengono conteggiate, e una Storia creata da un account lì risulta con 0 risposte. Con Instagram Login non esiste il webhook story_insights, quindi i numeri delle Storie vanno letti mentre la Storia è online.

Un carosello viene riportato come un unico post: Meta non restituisce insights per le foto e i video al suo interno.

Perché i nomi delle metriche cambiano?

Perché Meta ritira e rinomina le metriche tra una versione dell'API e l'altra. impressions è stata deprecata per la v22.0 e ha smesso di funzionare in ogni versione il 21 aprile 2025, tranne che sui media creati prima del 2 luglio 2024; al suo posto è stata introdotta views, e nello stesso momento sono state eliminate plays, clips_replays_count e ig_reels_aggregated_all_plays_count. video_views e diverse serie temporali del profilo, tra cui profile_views, erano state rimosse prima. Una richiesta con un nome ritirato fallisce, quindi un elenco di metriche scritto per una versione precedente dell'API può richiedere un aggiornamento.

Errori comuni

  • Richiedere impressions. Non funziona più in nessuna versione dell'API; chiedi invece views.
  • Considerare un risultato vuoto come zero. Meta restituisce un insieme di dati vuoto quando una metrica non è disponibile, che non equivale a nessuna attività.
  • Leggere le metriche delle Storie dopo che la Storia è scaduta. Sono disponibili solo per 24 ore.
  • Aggiungere una suddivisione a una richiesta di più metriche. Se una di esse non la supporta, l'intera chiamata fallisce.
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 i primi 3 giorni di prova gratuita.

Domande frequenti

Cosa ha sostituito impressions nell'API di Instagram?

views, che conta le volte in cui il contenuto è stato riprodotto o visualizzato. Meta ha ritirato impressions in ogni versione dell'API il 21 aprile 2025, tranne che sui media creati prima del 2 luglio 2024.

Perché il mio account non restituisce dati sui follower?

Meta non restituisce follows_and_unfollows né i dati demografici dei follower per gli account con meno di 100 follower.

Fino a quando posso leggere gli insights di Instagram?

Fino a 90 giorni di metriche dell'account e fino a 2 anni di metriche dei media, con online_followers che copre solo gli ultimi 30 giorni.

I numeri includono gli annunci?

In parte. Reach e account coinvolti di un account includono gli annunci, mentre like, commenti e views di un post contano solo l'attività organica.

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