Represents social interaction metrics on an IG Media object.
Due to privacy rules, messaging-related Story IG Media interactions performed by users in some regions are no longer included in some metric calculations. These regions include: Europe starting December 1, 2020 and Japan starting April 14, 2021.
This operation is not supported.
GET /{ig-media-id}/insights
Get insights data on an IG Media object.
Instagram
topic and subscribe to the story_insights
field.10
with the message (#10) Not enough viewers for the media to show insights
.0
for individual metrics.Type | Description |
---|---|
If the app user was granted a role on the Page via the Business Manager, you will also need one of: |
GET https://graph.facebook.com/v13.0
/{ig-media-id}/insights
?metric={metric}
&access_token={access-token}
Parameter | Value |
---|---|
Type: string | Required. App user's User access token. |
Type: Comma-separated list | Required. Comma-separated list of Metrics you want returned. |
Metric | Description |
---|---|
| Total number of likes and IG Comments on the album IG Media object. |
| Total number of times the album IG Media object has been seen. |
| Total number of unique Instagram accounts that have seen the album IG Media object. |
| Total number of unique Instagram accounts that have saved the album IG Media object. |
| Total number of unique Instagram accounts that have viewed video IG Media within the album. |
Metrics on media within an album are not supported. Get metrics on the album instead.
Metric | Description |
---|---|
| Sum of |
| Total number of times the IG Media object has been seen. |
| Total number of unique Instagram accounts that have seen the IG Media object. |
| Total number of unique Instagram accounts that have saved the IG Media object. |
| Total number of times the video IG Media has been seen. For album IG Media, the number of times all videos within the album have been seen. |
Metric | Description |
---|---|
| Total number of times someone exited the story IG Media object. |
| Total number of times the story IG Media object has been seen. |
| Total number of unique Instagram accounts that have seen the story IG Media object. |
| Total number of replies (IG Comments) on the story IG Media object. Value does not include replies made by users in some regions. These regions include: Europe starting December 1, 2020 and Japan starting April 14, 2021. If the Story was created by a user in one of these regions, returns a value of |
| Total number of taps to see this story IG Media object's next photo or video. |
| Total number of taps to see this story IG Media object's previous photo or video. |
curl -X GET \
'https://graph.facebook.com/v13.0
/17895695668004550/insights?metric=impressions,reach&access_token=IGQVJ...'
{ "data": [ { "name": "impressions", "period": "lifetime", "values": [ { "value": 264 } ], "title": "Impressions", "description": "Total number of times the media object has been seen", "id": "17855590849148465/insights/impressions/lifetime" }, { "name": "reach", "period": "lifetime", "values": [ { "value": 103 } ], "title": "Reach", "description": "Total number of unique accounts that have seen the media object", "id": "17855590849148465/insights/reach/lifetime" } ] }
This operation is not supported.
This operation is not supported.