Insights

This edge allows you to get all insights for individual media objects.

Creating

This operation is not supported.

Reading

Getting Insights Data

To get insights data for an individual media object, send a GET request to the /media/insights edge and include the metric parameter with one or more of the metric values you want returned. Please note the following limitations:

  • Insights data is not available for media objects within album carousels (children).
  • Stories insights are only available for 24 hours, even if the stories are archived or highlighted. If you want to get the latest insights for a story before it expires, set up a Webhook for the Instagram topic and subscribe to the story_insights field.

Photo & Video Metrics

MetricDescription

engagement

Total number of likes and comments on the media object.

impressions

Total number of times the media object has been seen.

reach

Total number of unique accounts that have seen the media object.

saved

Total number of unique accounts that have saved the media object.

video_views

(Videos only) Total number of times the video has been seen. Returns 0 for videos in carousel albums.

Carousel Album Metrics

MetricDescription

carousel_album_engagement

Total number of likes and comments on the carousel album.

carousel_album_impressions

Total number of times the carousel album has been seen.

carousel_album_reach

Total number of unique accounts that have seen the carousel album.

carousel_album_saved

Total number of unique accounts that have saved the carousel album.

carousel_album_video_views

(Videos only) Always returns 0. Use carousel_album_reach and carousel_album_impressions instead.

Story Metrics

MetricDescription

exits

Number of times someone exited the story.

impressions

Total number of times the story has been seen.

reach

Total number of unique accounts that have seen the story.

replies

Total number of replies to the story.

taps_forward

Total number of taps to see this story's next photo or video.

taps_back

Total number of taps to see this story's previous photo or video.

Permissions

A User access token with the following permissions:

  • instagram_basic
  • instagram_manage_insights

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

Sample Request

GET graph.facebook.com
  /17895695668004550/insights?metric=impressions,reach

Sample Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.