Lire les statistiques

Renvoie les derniers chiffres valides collectés par Sofia pour chaque compte connecté. Un compte pas encore collecté affiche awaiting, jamais zéro.

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

GET/v1/establishments/{id}/insights

Clé API ou jeton d’accèsConservé dans cet onglet uniquement, et envoyé uniquement à 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"

Autorisations

Authorizationstringrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de chemin

idstringrequis
Identifiant de l’établissement.

Paramètres de requête

periodstring
La période ; les 28 derniers jours si elle est omise.
Valeurs autorisées : last24Hourslast7Dayslast28Days

Réponse

200application/json

Les chiffres de chaque compte connecté.

establishmentIdstringrequis
Identifiant de l’établissement.
periodstringrequis
Période couverte par les chiffres
Valeurs autorisées : last24Hourslast7Dayslast28Days
dataobject[]requis
Les chiffres de chaque compte connecté
Afficher les attributs enfants
- platformstringrequis
  Identifiant de la plateforme du réseau
- viewsobjectrequis
  Nombre d’affichages ou de lectures du contenu. Instagram l’appelle views ; il peut compter plusieurs fois le même compte, il n’est donc jamais interchangeable avec la portée.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- reachobjectrequis
  Comptes uniques qui ont vu le contenu au moins une fois, sur la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectrequis
  Évolution de la portée par rapport à la période précédente, en pourcentage signé.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- accountsEngagedobjectrequis
  Comptes uniques qui ont interagi avec le contenu.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- totalInteractionsobjectrequis
  Mentions J’aime, commentaires, enregistrements, partages et autres interactions prises en charge.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- likesobjectrequis
  Mentions J’aime sur la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- commentsobjectrequis
  Commentaires sur la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- sharesobjectrequis
  Partages sur la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- savesobjectrequis
  Enregistrements sur la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- engagementRatePercentobjectrequis
  Interactions totales divisées par les comptes touchés, en pourcentage. Calculé par Sofia, pas un chiffre fourni par la plateforme. Indisponible quand la portée manque ou vaut zéro.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectrequis
  Évolution du taux d’engagement par rapport à la période précédente, en points.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- followersDeltaobjectrequis
  Variation nette d’abonnés sur la période. Meta la retient pour les comptes Instagram sous 100 abonnés, signalée par below-follower-threshold, ni comme une erreur ni comme 0.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectrequis
  Publications parues pendant la période.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- followersTotalobjectrequis
  Nombre total d’abonnés fourni par le profil connecté. Sur Instagram, il vient de instagram_business_basic, pas d’Insights. available avec la valeur 0 signifie que la plateforme a indiqué zéro ; une absence est unavailable avec sa raison, ce ne sont jamais le même chiffre.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- postsTotalobjectrequis
  Nombre total de publications sur le réseau, depuis toujours, fourni par le profil connecté. Même contrat que followersTotal : un zéro indiqué reste zéro, une absence reste absente.
  Afficher les attributs enfants
  - statusstringrequis
    Indique si la plateforme a réellement fourni cette métrique. available peut porter une valeur de 0, un zéro mesuré. unavailable ne porte jamais de valeur.
    Valeurs autorisées : availableunavailable
  - valuenumber
    Le chiffre mesuré. Présent seulement quand le statut est available ; 0 est une vraie valeur.
  - reasonstring
    Pourquoi la métrique manque. below-follower-threshold : Meta retient les métriques d’audience sous 100 abonnés, ce n’est pas une erreur. permission-denied : il manque une permission Insights sur le compte connecté, définitif jusqu’à la reconnexion du propriétaire, jamais transitoire. not-collected : Sofia ne mesure pas encore ce chiffre sur cet endpoint, la plateforme n’a jamais été interrogée, elle n’est donc pas en cause.
    Valeurs autorisées : not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Vrai tant que la plateforme peut encore compléter cette fenêtre ; Instagram publie certains chiffres jusqu’à 48 heures en retard.
  - sourceMetricstring
    Le champ de la plateforme dont vient ce chiffre, full_video_watched_rate sur TikTok, post_video_view_time sur Facebook. Deux réseaux appellent « complétion » des choses différentes ; sans ce champ, un rapport les mettrait côte à côte comme si elles étaient comparables.
  - granularitystring
    Ce que couvre le chiffre : un total depuis toujours, une heure, un jour, toute la période demandée telle que le réseau l’a agrégée, ou une seconde de vidéo. Une série quotidienne, un agrégat de période et un total cumulé ne sont pas la même mesure : ne les tracez pas sur le même axe et ne les additionnez pas.
    Valeurs autorisées : lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanrequis
  Vrai quand au moins un appel Insights a réussi. Les abonnés et le nombre de publications viennent aussi du profil de base, leur présence seule ne prouve donc pas que les Insights sont lisibles.
- mayBeDelayedbooleanrequis
  Vrai tant que la plateforme peut encore compléter cette fenêtre (jusqu’à 48 heures).
- socialAccountIdstringrequis
  Le compte connecté auquel ces chiffres appartiennent.
- collectionobjectrequis
  Les données de collecte derrière ces chiffres.
  Afficher les attributs enfants
  - statestringrequis
    awaiting-first-collection : le compte est connecté et aucune réponse valide n’existe encore, chaque métrique vaut not-collected.
    Valeurs autorisées : collectedawaiting-first-collection
  - isOutdatedbooleanrequis
    Vrai quand une tentative plus récente a échoué, ou que la prochaine collecte a plus d’une heure de retard. Les chiffres restent valables pour leur fenêtre et leur date ; ils ne sont pas à jour.
  - isCollectingbooleanrequis
    Vrai tant qu’une collecte de ce compte est en cours.
  - collectedAtnumber
    Moment où le réseau a répondu (unix ms).
  - windowStartnumber
    Début de la fenêtre demandée au réseau (unix ms).
  - windowEndnumber
    Fin de la fenêtre demandée au réseau (unix ms).
  - completenessstring
    partial : le réseau n’a répondu que sur une partie de la fenêtre, ou certaines métriques ont échoué.
    Valeurs autorisées : completepartial
  - nextCollectionAtnumber
    Moment prévu de la prochaine collecte (unix ms).
  - lastFailedAttemptobject
    La dernière tentative, quand elle s’est terminée après les chiffres affichés et n’a pas abouti.
    Afficher les attributs enfants
    atnumberrequis
    Fin de la tentative (unix ms)
    outcomestringrequis
    deferred : le réseau a demandé à Sofia d’attendre (limite de débit, quota). failed : tout le reste.
    Valeurs autorisées : faileddeferred
    reasonstring
    Pourquoi, tel que Sofia l’a classé (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Valeurs quotidiennes de portée. Absent quand la plateforme n’a renvoyé aucune série, jamais rempli de zéros.
- engagementDailySeriesnumber[]
  Taux d’engagement quotidien en pourcentage. Absent sur Instagram : total_interactions n’a pas de mode série temporelle, donc aucun taux quotidien honnête n’existe.
- followersDailySeriesnumber[]
  Variation nette quotidienne d’abonnés. Absent quand la plateforme ne la fournit pas.
- fetchedAtnumber
  Moment où le réseau a répondu (unix ms). Absent tant que la première collecte n’a pas réussi.

401

Le jeton est absent, inconnu, expiré ou révoqué.

403

Le jeton n’a pas la permission insights:read.

404

Établissement hors du Workspace du jeton.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.

Lire les statistiques

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