Insights

L’API Instagram Graph permet de mesurer les interactions sur les réseaux sociaux d’utilisateur·ices Instagram et de leurs objets IG Media. Les valeurs de chaque indicateur sont calculés lors de la requête API.

Conformément aux règles de confidentialité, les interactions d’utilisateur·ices de certaines régions avec un objet IG Media de stories liées à la messagerie ne seront plus prises en compte dans certains calculs d’indicateurs. Ces régions sont les suivantes : Europe (à compter du 1er décembre 2020) et Japon (à compter du 14 avril 2021).

  • Pour les stories créées par des utilisateur·ices des zones concernées, l’indicateur replies renverra désormais une valeur de 0.
  • Pour les stories créées par des utilisateur·ices résidant en dehors de ces zones, l’indicateur replies renverra le nombre de réponses, mais les réponses des utilisateur·ices de ces zones-là ne seront pas prises en compte dans ce calcul.

Limites

  • Certains indicateurs ne sont disponibles que pour les utilisateur·ices Instagram ayant au moins 100 abonnés.
  • L’API renvoie uniquement des indicateurs d’interactions organiques. Les interactions avec les publicités contenant un objet multimédia ne sont pas prises en compte.
  • Les données sur les indicateurs de contenu multimédia sont stockées pendant deux ans maximum. Les données sur les indicateurs des utilisateur·ices sont stockées pendant 90 jours.
  • Vous pouvez obtenir des statistiques sur un seul utilisateur ou une seule utilisatrice à la fois.
  • Il est impossible d’obtenir des statistiques concernant des Pages Facebook.
  • Les statistiques des stories sont disponibles pendant 24 heures seulement, même si celle-ci est archivée ou ajoutée aux stories à la une. Si vous souhaitez obtenir les dernières statistiques sur une story avant qu’elle n’expire, configurez un webhook pour ce sujet Instagram et abonnez-vous au story_insights site.
  • Les statistiques sur l’objet IG Media d’albums enfants ne sont pas pris en charge.
  • Si les données statistiques demandées n’existent pas ou sont actuellement indisponibles, l’API retourne un ensemble de données vide au lieu de la valeur 0 pour les indicateurs individuels.

UTC

Les horodatages figurant dans les réponses de l’API utilisent l’heure UTC +0 selon la norme standard internationale ISO-8601. Par exemple : 2019-04-05T07:56:32+0000

Points de terminaison

L’API se compose des points de terminaison suivants :

Pour connaître les paramètres disponibles et les exigences en matière d'autorisation, consultez la documentation de référence de chaque point de terminaison.

Exemples

Obtenir des indicateurs sur un compte

Pour obtenir des indicateurs sur un compte Instagram Business ou Creator, lancez une recherche sur l’Edge GET /{ig-user-id}/insights et spécifiez les indicateurs à renvoyer.

Exemple de requête

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

Exemple de réponse

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

Obtenir des indicateurs sur un objet média

Pour obtenir des indicateurs sur un objet média, lancez une recherche sur l’Edge GET /{ig-media-id}/insights et spécifiez les indicateurs à renvoyer.

Exemple de requête

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

Exemple de réponse

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}