Leggere le statistiche

Restituisce gli ultimi dati validi raccolti da Sofia per ogni account collegato. Un account non ancora raccolto mostra awaiting, mai zero.

GEThttps://api.sofia-post.com/api/v1/establishments/{id}/insights

GET/v1/establishments/{id}/insights

Chiave API o access tokenConservato solo in questa scheda e inviato solo ad api.sofia-post.com.id (path)period (query)

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorizzazioni

Authorizationstringobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Parametri di percorso

idstringobbligatorio
Identificatore dell'attività.

Parametri di query

periodstring
Il periodo; gli ultimi 28 giorni se omesso.
Valori ammessi: last24Hourslast7Dayslast28Days

Risposta

200application/json

I dati di ogni account collegato.

establishmentIdstringobbligatorio
Identificatore dell'attività.
periodstringobbligatorio
Periodo coperto dai dati
Valori ammessi: last24Hourslast7Dayslast28Days
dataobject[]obbligatorio
I dati di ogni account collegato
Mostra gli attributi figli
- platformstringobbligatorio
  Identificatore della piattaforma della rete
- viewsobjectobbligatorio
  Quante volte il contenuto è stato mostrato o riprodotto. Instagram lo chiama views; può contare più volte lo stesso account, quindi non è mai intercambiabile con la copertura.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- reachobjectobbligatorio
  Account unici che hanno visto il contenuto almeno una volta nel periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectobbligatorio
  Variazione della copertura rispetto al periodo precedente, in percentuale con segno.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- accountsEngagedobjectobbligatorio
  Account unici che hanno interagito con il contenuto.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- totalInteractionsobjectobbligatorio
  Mi piace, commenti, salvataggi, condivisioni e altre interazioni supportate.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- likesobjectobbligatorio
  Mi piace nel periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- commentsobjectobbligatorio
  Commenti nel periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- sharesobjectobbligatorio
  Condivisioni nel periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- savesobjectobbligatorio
  Salvataggi nel periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectobbligatorio
  Interazioni totali divise per gli account raggiunti, in percentuale. Calcolato da Sofia, non è un dato riportato dalla piattaforma. Non disponibile quando la copertura manca o è zero.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectobbligatorio
  Variazione del tasso di coinvolgimento rispetto al periodo precedente, in punti.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- followersDeltaobjectobbligatorio
  Variazione netta dei follower nel periodo. Meta la trattiene per gli account Instagram sotto i 100 follower, segnalata come below-follower-threshold, né come errore né come 0.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectobbligatorio
  Pubblicazioni uscite durante il periodo.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- followersTotalobjectobbligatorio
  Numero assoluto di follower riportato dal profilo collegato. Su Instagram viene da instagram_business_basic, non da Insights. available con valore 0 significa che la piattaforma ha riportato zero; un'assenza è unavailable con il suo motivo, non sono mai lo stesso dato.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- postsTotalobjectobbligatorio
  Numero assoluto di pubblicazioni sulla rete, da sempre, riportato dal profilo collegato. Stesso contratto di followersTotal: uno zero riportato resta zero, un'assenza resta assente.
  Mostra gli attributi figli
  - statusstringobbligatorio
    Se la piattaforma ha davvero riportato questa metrica. available può avere il valore 0, uno zero misurato. unavailable non ha mai un valore.
    Valori ammessi: availableunavailable
  - valuenumber
    Il dato misurato. Presente solo quando lo stato è available; 0 è un valore reale.
  - reasonstring
    Perché la metrica manca. below-follower-threshold: Meta trattiene le metriche di pubblico sotto i 100 follower, non è un errore. permission-denied: manca un permesso Insights sull'account collegato, definitivo finché il titolare non lo ricollega, mai transitorio. not-collected: Sofia non misura ancora questo dato su questo endpoint, la piattaforma non è mai stata interrogata, quindi non ha colpa.
    Valori ammessi: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vero finché la piattaforma può ancora completare questa finestra; Instagram pubblica alcuni dati con fino a 48 ore di ritardo.
  - sourceMetricstring
    Il campo della piattaforma da cui deriva questo dato, full_video_watched_rate su TikTok, post_video_view_time su Facebook. Due reti chiamano «completamento» cose diverse; senza questo campo, un report le metterebbe affiancate come se fossero confrontabili.
  - granularitystring
    Cosa copre il dato: un totale complessivo, un'ora, un giorno, l'intero periodo richiesto come l'ha aggregato la rete, o un secondo di video. Una serie giornaliera, un aggregato di periodo e un totale complessivo non sono la stessa misura: non vanno sullo stesso asse né sommati.
    Valori ammessi: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanobbligatorio
  Vero quando almeno una chiamata a Insights è riuscita. Follower e numero di pubblicazioni vengono anche dal profilo di base, quindi la loro presenza non prova che gli Insights siano leggibili.
- mayBeDelayedbooleanobbligatorio
  Vero finché la piattaforma può ancora completare questa finestra (fino a 48 ore).
- socialAccountIdstringobbligatorio
  L'account collegato a cui appartengono questi dati.
- collectionobjectobbligatorio
  I dati di raccolta dietro questi dati.
  Mostra gli attributi figli
  - statestringobbligatorio
    awaiting-first-collection: l'account è collegato e non esiste ancora una risposta valida, ogni metrica vale not-collected.
    Valori ammessi: collectedawaiting-first-collection
  - isOutdatedbooleanobbligatorio
    Vero quando un tentativo successivo non è riuscito, o la prossima raccolta ha più di un'ora di ritardo. I dati restano validi per la loro finestra e data; non sono aggiornati.
  - isCollectingbooleanobbligatorio
    Vero finché è in corso una raccolta di questo account.
  - collectedAtnumber
    Quando la rete ha risposto (unix ms).
  - windowStartnumber
    Inizio della finestra richiesta alla rete (unix ms).
  - windowEndnumber
    Fine della finestra richiesta alla rete (unix ms).
  - completenessstring
    partial: la rete ha risposto solo per una parte della finestra, oppure alcune metriche sono fallite.
    Valori ammessi: completepartial
  - nextCollectionAtnumber
    Quando è prevista la prossima raccolta (unix ms).
  - lastFailedAttemptobject
    L'ultimo tentativo, quando è finito dopo i dati mostrati e non è riuscito.
    Mostra gli attributi figli
    atnumberobbligatorio
    Quando è finito il tentativo (unix ms)
    outcomestringobbligatorio
    deferred: la rete ha chiesto a Sofia di attendere (rate limit, quota). failed: tutto il resto.
    Valori ammessi: faileddeferred
    reasonstring
    Perché, come l'ha classificato Sofia (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Valori giornalieri di copertura. Assente quando la piattaforma non ha restituito alcuna serie, mai riempito di zeri.
- engagementDailySeriesnumber[]
  Tasso di coinvolgimento giornaliero in percentuale. Assente su Instagram: total_interactions non ha una modalità serie temporale, quindi non esiste un tasso giornaliero onesto.
- followersDailySeriesnumber[]
  Variazione netta giornaliera dei follower. Assente quando la piattaforma non la riporta.
- fetchedAtnumber
  Quando la rete ha risposto (unix ms). Assente finché la prima raccolta non riesce.

401

Il token manca, è sconosciuto, scaduto o revocato.

403

Il token non ha il permesso insights:read.

404

Attività fuori dal Workspace del token.

4XXapplication/json

Qualsiasi altro errore, nella busta di errore.

Leggere le statistiche

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/insights' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "establishmentId": "string",
  "period": "last24Hours",
  "data": [
    {
      "platform": "instagram",
      "views": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reach": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDeltaPercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "accountsEngaged": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "totalInteractions": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "likes": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "comments": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "shares": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "saves": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementRatePercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementDeltaPoints": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "followersDelta": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsPublishedDuringPeriod": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDailySeries": [
        0
      ],
      "followersDailySeries": [
        0
      ],
      "followersTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "hasInsightsData": true,
      "mayBeDelayed": false,
      "fetchedAt": 1739539200000,
      "socialAccountId": "acc_123",
      "collection": {
        "state": "collected",
        "collectedAt": 1739539200000,
        "completeness": "complete",
        "isOutdated": false,
        "isCollecting": false
      }
    }
  ]
}