The following metrics are calculated by this application:

• 1) ID: The ID associated with this media.
• 2) Media Type: The media's type. Can be IMAGE, VIDEO, or CAROUSEL ALBUM.
• 3) Likes: The number of likes this media received.
• 4) Comments: The number of comments this media received
• 5) Saved: The number of times this media was saved.
• 6) Shares: The number of times this media was shared.
• 7) Total interactions: Sum of likes, saves, comments, and shares.

The following metrics are only calculated for video posts:

• 8) Video Views: The number of times this video has been watched for at least 3 seconds.
• 9) Replays: The number of times this video has been replayed for at least 1 millisecond.
• 10) Plays: The number of times this video has been initially played for at least 1 millisecond.
• 11) Total Plays: The total number of times this video has been played for at least 1 millisecond.
• 12) Total Watch-time: The total amount of time spent watching this video, measured in hours.

And the following metrics are only calculated for non-video posts:

• 13) Follows: The number of times a user followed after viewing this post.*
• 14) Impressions: The number of times this post has been viewed.
• 15) Profile activity: The number of actions taken on this post.*
  (Possible actions are: 1) Bio link clicked, 2) Call, 3) Direction, 4) Email, 5) Text, 6) Other)
• 16) Profile visits: The number of profile visits from this post.
  
  *While these metrics are visible for videos on insights pages, (as of August 2024) they are currently not returned for videos via the Insights API.

And these last metrics are also included for organizational purposes

• 17) Owner: The owner of this media, in case insights are calculated for multiple accounts.
• 18) Timestamp: The date and time this media was published, in UTC.
• 19) Permalink: The public viewable link to this media.
• 20) Errors: Any errors encountered with calculating insights for this media.

Lastly, the Insights API will not return any data for posts created before a user created a professional Business or Creator account, regardless if metrics are currently viewable on their respective insights pages or not. (as of August 2024)

API Details regarding media info can be found here.
API Details regarding media insights can be found here.

back to project