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).
replies
renverra désormais une valeur de 0
.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.Instagram
et abonnez-vous au story_insights
site.0
pour les indicateurs individuels.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
L’API se compose des points de terminaison suivants :
GET /{ig-media-id}/insights
: permet d’obtenir des indicateurs sur un objet médiaGET /{ig-user-id}/insights
: permet d’obtenir des indicateurs sur un compte Instagram Business ou Instagram CreatorPour 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.
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.
GET graph.facebook.com/17841405822304914/insights ?metric=impressions,reach,profile_views &period=day
{ "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" } ] }
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.
GET graph.facebook.com/{media-id}/insights ?metric=engagement,impressions,reach
{ "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" } ] }