This page lists metrics and calculations that you can specify when you define your own custom metrics.

Cross-platform metrics

Calculation source shows which platforms are supported and which internal alias is used for the calculation. Only the listed platforms are used when calculating the metric.

To review calculation sources, see the specific social network sections and look up the metric alias.

Metric alias

Metric description

Calculation source

page_posts

Number of content pieces

Facebook: page_posts
Instagram: profile_posts
Twitter: profile_tweets
YouTube: channel_videos
LinkedIn: profile_posts
Pinterest: profile_posts
TikTok: profile_posts

interactions

Number of interactions. Includes reactions, comments, shares

Facebook: interactions
Instagram: interactions
Twitter: interactions
YouTube: interactions
LinkedIn: interactions
Pinterest: interactions

interactions_per_1k_fans

Number of interactions per 1000 fans. interactions / fans * 1000

Facebook: interactions_per_1k_fans
Instagram: interactions_per_1k_fans
Twitter: interactions_per_1k_fans
YouTube: interactions_per_1k_fans
LinkedIn: interactions_per_1k_fans

engagement_rate

Number of interactions per 1 fan in %. interactions / fans * 100

Facebook: engagement_rate
Instagram: engagement_rate
Twitter: engagement_rate
YouTube: engagement_rate
LinkedIn: engagement_rate

insights_impressions

Number of impressions

Facebook: insights_impressions
Instagram: insights_impressions
Twitter: insights_impressions
LinkedIn: insights_impressions

number_of_comments

Number of comments

Facebook: number_of_comments
Instagram: number_of_comments
Twitter: number_of_comments
YouTube: number_of_comments
LinkedIn: number_of_comments
Pinterest: number_of_comments
TikTok: number_of_comments

insights_reach_per_content

Number of unique impressions.

Facebook: insights_reach_per_content
Instagram: insights_reach_per_content
TikTok: insights_reach_per_content
LinkedIn: reach

insights_completion_rate

The percentage of times a Story impression was not interrupted by an exit, tap back or tap forward.

Instagram: insights_completion_rate
TikTok: insights_completion_rate

insights_story_exits

Number of times someone exited the story IG Media object.

Instagram: insights_story_exits

insights_story_taps_forward

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

Instagram: insights_story_taps_forward

insights_story_taps_back

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

Instagram: insights_story_taps_back

insights_engagements

Number of engaged users.

Facebook: insights_engagements
Instagram: insights_engagements
Twitter: insights_engagements
YouTube: insights_engagements

insights_engagements_v2

Engagements returns the number of times that users engaged with your post during its lifetime.

Facebook: insights_engagements_v2
Instagram: insights_engagements_v2
TikTok: insights_engagements
Twitter: insights_engagements
YouTube: insights_engagements
LinkedIn: insights_engagements

insights_impressions_engagement_rate

Lifetime percentage of engagements divided by impressions.

Facebook: insights_impressions_engagement_rate
Instagram: insights_impressions_engagement_rate
Twitter: insights_impressions_engagement_rate
LinkedIn: insights_impressions_engagement_rate

insights_media_views

TODO

Twitter: insights_media_views

insights_video_views

Number of views the video has. Only available for videos.

Facebook: insights_video_views
Instagram: insights_video_views
LinkedIn: insights_video_views
TikTok: insights_video_views
Twitter: insights_video_views
YouTube: video_views

insights_video_views_v2

Number of views the video has. Only available for videos. Reads insights field on YT platform

Facebook: insights_video_views
Instagram: insights_video_views
LinkedIn: insights_video_views
TikTok: insights_video_views
Twitter: insights_video_views
YouTube: insights_video_views

insights_view_time

The number of seconds that users watched videos for the specified channel, content owner, video, or playlist.

Facebook: insights_view_time
LinkedIn: insights_view_time
YouTube: insights_view_time
TikTok: insights_view_time

insights_avg_view_percentage

The average percentage of a video watched during a video playback.

YouTube: insights_avg_view_percentage

insights_avg_time_watched

The average length in seconds of video playbacks

Facebook: insights_avg_time_watched
YouTube: insights_avg_time_watched
TikTok: insights_avg_time_watched

insights_subscribers_change

The result of number of subscribers gained minus the number of subscribers lost

YouTube: insights_subscribers_change

insights_reach_engagement

Engagement rate from Facebook

Facebook: insights_reach_engagement

insights_reach_engagement_rate_v2

Sum of reactions, shares, saves, comments and replies divided by reach.

Facebook: insights_reach_engagement_rate_v2
Instagram: insights_reach_engagement_rate
TikTok: insights_reach_engagement_rate
LinkedIn: reach_engagement_rate

insights_post_clicks

Number of interactions on the content piece. Includes link clicks, photo views, video plays and other clicks.

Facebook: insights_post_clicks
LinkedIn: insights_post_clicks

insights_post_saves

Total number of unique Instagram accounts that have saved the IG Media object.

Instagram: insights_post_saves

insights_post_video_views_unique

Number of unique video viewers.

Facebook: insights_post_video_views_unique
LinkedIn: insights_post_unique_views

reactions

Number of reactions.

Facebook: reactions

Facebook

Metric alias

Metric description

page_posts

Number of content pieces.

interactions

Number of interaction. Includes reactions, comments and shares

insights_impressions

Number of impressions

reactions

Number of reactions.

insights_video_views

Number of views the video has. Only available for videos.

insights_avg_time_watched

The average length in seconds of video playbacks

insights_post_clicks

Number of interactions on the content piece. Includes link clicks, photo views, video plays and other clicks.

insights_reach_engagement

Engagement rate from Facebook

insights_reach_engagement_rate_v2

Sum of posts reactions, shares, comments and post clicks divided by reach.

insights_impressions_engagement_rate

Lifetime percentage of engagements (reactions, shares, comments and post clicks) divided by impressions.

total_video_view_time

Total time videos were viewed in seconds.

likes

Number of reactions. Use `reactions` instead

interactions_per_1k_fans

Number of interactions per 1000 fans. interactions / fans * 1000

engagement_rate

Number of interactions per 1 fan in %. interactions / fans * 100

insights_engagements

Number of engaged users.

insights_engagements_v2

Engagements returns the number of times that users engaged with your post during its lifetime.

number_of_comments

Number of comments

insights_reach_per_content

Number of unique impressions.

insights_post_video_views_unique

Number of unique video viewers.

insights_view_time

The number of seconds that users watched videos for the specified channel, content owner, video, or playlist.

shares

Number of shares of the post.

insights_link_clicks

Click the "Details" link beside the shortened URL in Goo.gl to view basic click statistics, including the number of people who clicked the link on your Facebook wall.

Instagram

To review calculation sources, see the Instagram Stories or Instagram Posts sections and look up the metric alias.

Metric alias

Metric description

Calculation source

profile_posts

Number of content pieces

posts: profile_posts
stories: profile_posts

interactions

Number of interactions. Includes likes and comments

posts: interactions

number_of_comments

Total number of comments (post + stories)

posts: number_of_comments
stories: number_of_comments

number_of_post_comments

Number of comments - posts only

posts: number_of_post_comments

insights_story_replies

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 0.

stories: insights_story_replies

insights_impressions

Total number of times the IG Media object has been seen.

posts: insights_impressions
stories: insights_impressions

insights_impressions_or_video_views

Returns insights_impressions if they are present else returns video_views - to supply missing reels impressions

posts: insights_impressions_or_video_views
stories: insights_impressions_or_video_views

insights_impressions_engagement_rate

Lifetime percentage of engagements (Likes, comments, saves and replies) divided by impressions.

posts: insights_impressions_engagement_rate
stories: insights_impressions_engagement_rate

insights_video_views

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. Available for videos and igtv videos. (Including video carousels.)

posts: insights_video_views

interactions_per_1k_fans

Number of interactions per 1000 followers. interactions / followers * 1000

posts: interactions_per_1k_fans

engagement_rate

Number of interactions per 1 follower in %. interactions / followers * 100

posts: engagement_rate

insights_engagements

Sum of likes_count, comment_count and saved counts on the IG Media.

posts: insights_engagements

insights_engagements_v2

Engagements returns the number of times that users engaged with your post during its lifetime.

posts: insights_engagements
stories: number_of_comments

insights_reach_engagement_rate

Sum of post likes, shares, comments and saves or story replies divided by reach.

posts: insights_reach_engagement_rate
stories: insights_reach_engagement_rate

insights_reach_per_content

Total number of unique Instagram accounts that have seen the IG Media object.

posts: insights_reach_per_content
stories: insights_reach_per_content

insights_post_saves

Total number of unique Instagram accounts that have saved the IG Media object.

posts: insights_post_saves

insights_completion_rate

The percentage of times a Story impression was not interrupted by an exit, tap back or tap forward.

stories: insights_completion_rate

insights_story_exits

Number of times someone exited the story IG Media object.

stories: insights_story_exits

insights_story_taps_forward

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

stories: insights_story_taps_forward

insights_story_taps_back

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

stories: insights_story_taps_back

insights_shares

The number of times your post/story/reel was shared

posts: insights_shares

like_count

The number of likes.

posts: like_count

Instagram Stories

Metric alias

Metric description

profile_posts

Number of content pieces

insights_impressions

Total number of times the story IG Media object has been seen.

insights_impressions_or_video_views

Returns insights_impressions if they are present else returns video_views - to supply missing reels impressions

number_of_comments

Total number of replies (IG Comments) on the story IG Media object (story + post). 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 0.

insights_impressions_engagement_rate

Lifetime percentage of engagements (replies) divided by impressions.

insights_reach_engagement_rate

Sum of posts replies divided by reach.

insights_reach_per_content

Total number of unique Instagram accounts that have seen the IG Media object.

insights_completion_rate

The percentage of times a Story impression was not interrupted by an exit, tap back or tap forward.

insights_story_exits

Number of times someone exited the story IG Media object.

insights_story_replies

Number of story replies (excluding posts).

insights_story_taps_forward

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

insights_story_taps_back

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

like_count

The number of likes on an IG Media object.

Instagram Posts

Metric alias

Metric description

profile_posts

Number of content pieces

interactions

Number of interactions. Includes likes and comments

insights_impressions

Total number of times the IG Media object has been seen.

insights_impressions_or_video_views

Returns insights_impressions if they are present else returns video_views - to supply missing reels impressions

insights_video_views

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. Available for videos and igtv videos. (Including video carousels.)

interactions_per_1k_fans

Number of interactions per 1000 followers. interactions / followers * 1000

engagement_rate

Number of interactions per 1 follower in %. interactions / followers * 100

insights_engagements

Sum of likes_count, comment_count and saved counts on the IG Media.

number_of_comments

Number of comments (story + post)

number_of_post_comments

Number or post comments. (excluding stories)

insights_impressions_engagement_rate

Lifetime percentage of engagements (likes, comments and saves) divided by impressions.

insights_reach_engagement_rate

Sum of likes, shares, comments and saves divided by reach.

insights_reach_per_content

Total number of unique Instagram accounts that have seen the IG Media object.

insights_post_saves

Total number of unique Instagram accounts that have saved the IG Media object.

insights_shares

The number of times your post/reel was shared.

like_count

The number of likes on an IG Media object.

Twitter

Metric alias

Metric description

interactions

Number of all interactions (replies, retweets, likes).

insights_impressions

Number of times tweets have been seen

profile_tweets

Number of content pieces

interactions_per_1k_fans

Number of interactions per 1000 followers. Interactions / followers * 1000

engagement_rate

Number of interactions per 1 follower in %. Interactions / followers * 100

number_of_comments

Number of replies

insights_engagements

The total number of times a user interacted with tweets, including clicking anywhere on the tweet (hashtags, embedded media, username, profile photo, tweet expansion, cards, links, likes, retweets, follows) or replies, including organic and boosted data.

insights_impressions_engagement_rate

Lifetime percentage of engagements divided by impressions.

insights_media_views

Number of all views (autoplay and click) of media counted across videos, vines, gifs, and images.

insights_video_views

Views of a video that has been 50% visible for more than 2 seconds. 

LinkedIn

Metric alias

Metric description

profile_posts

Number of content pieces

interactions

Number of all interactions (reactions and comments)

interactions_per_1k_fans

Number of interactions per 1000 followers. Interactions / followers * 1000

engagement_rate

Number of interactions per 1 follower in %. Interactions / followers * 100

number_of_comments

Number of comments

insights_impressions

Number of impressions.

insights_engagements

Engagements returns the number of times that users engaged with your post during its lifetime.

insights_post_clicks

Number of interactions on the content piece.

insights_impressions_engagement_rate

Lifetime percentage of engagements divided by impressions.

insights_video_views

Number of views the video has. (6 months of historical data only)

insights_view_time

Total time videos were viewed in seconds. (6 months of historical data only)

insights_post_unique_views

Number of unique viewers the video has. (6 months of historical data only)

reach

Number of unique impressions.

reach_engagement_rate

Sum of likes, shares, comments and saves divided by reach.

insights_shares

The number of times your post was shared.

insights_reactions

The number of reactions on Media object.

Pinterest

Metric alias

Metric description

profile_posts

Number of content pieces

interactions

Number of all interactions (shares, comments, likes). Note: due to API changes we do not receive comments and likes now

number_of_comments

Number of comments. Note: due to API changes we do not receive comments now

TikTok

Metric alias

Metric description

profile_posts

Number of content pieces.

number_of_comments

Number of comments

insights_video_views

Number of views the video has.

insights_engagements

Engagements returns the number of times that users engaged with your post during its lifetime.

insights_reach_per_content

Number of unique impressions.

insights_reach_engagement_rate

Sum of likes, comments and shares divided by reach.

insights_view_time

The number of seconds that users watched videos for the specified channel, content owner, video, or playlist.

insights_completion_rate

The percentage of times a Post impression was not interrupted by an exit, tap back or tap forward.

insights_avg_time_watched

The average length in seconds of video playbacks

insights_shares

The number of times your post was shared.

insights_like_count

The number of likes on a Media object.

YouTube

Metric alias

Metric description

interactions

The number of interactions (likes and comments) received by a set of YouTube videos published during the selected date range.

channel_videos

Number of content pieces

video_views

Number of video views a YouTube channel received for videos published during a selected date range. YouTube counts a video view when someone watches the video for at least 30 seconds.

interactions_per_1k_fans

Number of interactions per 1000 followers. Interactions / followers * 1000

engagement_rate

Number of interactions per 1 follower in %. Interactions / followers * 100

number_of_comments

Number of comments

insights_view_time

The number of seconds that users watched videos for the specified channel, content owner, video, or playlist.

insights_engagements

Number of likes, dislikes, shares and comments on a video

insights_avg_view_percentage

The average percentage of a video watched during a video playback.

insights_subscribers_change

The result of number of subscribers gained minus the number of subscribers lost

insights_avg_time_watched

The average length in seconds of video playbacks

insights_video_views

Number of video views. Read from insights.view_count field

insights_shares

The number of times your post was shared.

insights_dislike_count

The number of dislikes on a video.

like_count

The number of likes.

insights_like_count

The number of likes.