Supermetrics brings all your marketing data into Google Sheets, Google Data Studio, Excel, BigQuery, Snowflake, Redshift, Azure

Field list for Facebook Insights

170 metrics and 78 dimensions available

CategoryFieldCodeTypeDescription
TIMEYearYeardimYear, e.g. 2017
Year & monthYearmonthdimYear and month, e.g. 2017|06
Year & week (Mon-Sun)YearweekdimYear and week for ISO weeks, e.g. 2017|08
QuarterQuarterdimQuarter, e.g. 1
MonthMonthdimMonth, e.g. 6
Week (Mon-Sun)WeekISOdimISO week number, e.g. 51
DateDatedimDate, e.g. 2017-01-31
PAGEPage nameprofiledim
Page IDprofileiddim
POSTPost IDpost_IDdim
Post namepost_namedim
Post creatorpost_creatordimName of post creator
Link to postpost_linktodim
Post typepost_typedim
Post messagepost_messagedim
Post storypost_storydim
Post descriptionpost_descriptiondim
Post status typepost_status_typedim
Post privacypost_privacydim
Post shared linkpost_linkdim
Post object IDpost_object_iddim
Post thumbnail URLpost_picturedim
Post image URLpost_full_picturedim
Post captionpost_captiondim
Post story tagspost_story_tagsdimThe list of tags in the post description
Post video length (s)post_video_lengthdim
Post creation time of daypost_created_time_of_daydim
POST COMMENTPost comment textpost_comment_textdimThe comment text
Post comment authorpost_comment_authordimAuthor of the comment
Post comment datepost_comment_datedimDate of the comment
Post comment timepost_comment_timedimTime of the comment
VIDEOVideo IDvideo_iddim
Universal video identifiervideo_universal_iddim
Video titlevideo_titledim
Video descriptionvideo_descriptiondim
Video content categoryvideo_content_categorydim
Video live statusvideo_live_statusdim
Video post publish statusvideo_publisheddim
Video image URLvideo_picturedim
Video source URLvideo_sourcedim
Video permalink URLvideo_permalink_urldim
Video embeddablevideo_embeddabledim
Video embed HTMLvideo_embed_htmldim
Video crossposting eligibilityvideo_is_crossposting_eligibledim
Video Instagram eligibilityvideo_is_instagram_eligibledim
Video length (s)video_lengthdim
Video creation time of dayvideo_created_time_of_daydim
Video backdated timevideo_backdated_timedim
Video backdated time granularityvideo_backdated_time_granularitydim
LOCATIONCountrycountrydim
Citycitydim
Languagelocaledim
DEMOGRAPHICSGendergenderdim
Ageagedim
Gender & agegenderagedim
FEED TARGETINGFeed targeting age minfeed_targeting_age_mindimMinimum age. Default is 0
Feed targeting age maxfeed_targeting_age_maxdimMaximum age
Feed targeting citiesfeed_targeting_citiesdimTargeting cities
Feed targeting collage yearsfeed_targeting_college_yearsdimTargeting graduation year from college
Feed targeting countriesfeed_targeting_countriesdimTargeting countries
Feed targeting education statusesfeed_targeting_education_statusesdimTargeting based on education levels
Feed targeting gendersfeed_targeting_gendersdimTargeting genders
Feed targeting interestsfeed_targeting_interestsdimTargeting fans interests
Feed targeting localesfeed_targeting_localesdimTargeted locales
Feed targeting regionsfeed_targeting_regionsdimTargeting regions
Feed targeting relation statusesfeed_targeting_relationship_statusesdimTargeting relationship statuses
REVIEWS/RECOMMENDATIONSReview creation datereview_created_datedimDate then review was created
Reviewer IDreviewer_iddimThe author ID of a recommendation/review
Reviewerreviewer_namedimThe author name of a recommendation/review
Has ratinghas_review_ratingdimWas a rating included in the recommendation/review (1-5 stars)
Has reviewhas_reviewdimWas there text in the rating in the recommendation/review
Recommendation typereview_recommendation_typedimWhether or not this recommendation was "positive" or "negative"
Review textreview_textdimReview text included in the review
OTHERContent click typeconsumption_typedim
Action typefeedback_typedim
Story typestory_typedim
DEPRECATEDPage tabtabdimPlease note that this field will be removed on 2024-03-14
Page like sourcelike_sourcedimPlease note that this field will be removed on 2024-03-14
PAGE LIKESTotal likespage_fansmetThe total number of people who have liked your Page
New likespage_fan_addsmetThe number of new people who have liked your Page
Page followerspage_followersmetNumber of page followers
New likes (unique users)page_fan_adds_uniquemetThe number of new people who have liked your Page (Unique users)
Unlikespage_fan_removesmet
Unlikes (unique users)page_fan_removes_uniquemetThe number of Unlikes of your Page (Unique users)
Net likesNetFanGrowthmetNew likes minus unlikes
Net likes growth rate (%)FanGrowthRate_percmetGrowth rate of your page likes
Likes churn rate (%)FanChurnRate_percmet
Page likers (fans) online per daypage_fans_online_per_daymetThe number of your fans who saw any posts on Facebook on a given day
REACHTotal reachpage_impressions_uniquemetThe number of people who have seen any content associated with your Page
Organic reachpage_impressions_organic_uniquemetThe number of people who saw any unpaid content from your Page or about your Page in News Feed or on visits to your Page
Paid reachpage_impressions_paid_uniquemetNumber of people who saw a sponsored story or Ad about your Page
Viral reachpage_impressions_viral_uniquemetThe number of people who saw your Page or one of its posts from a story published by a friend. These stories include liking your Page, posting to your Page's Timeline, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
Non-viral reachpage_impressions_nonviral_uniquemetThe number of people who had any content from your Page enter their screen. This does not include content created about your Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
% of reach from organicOrganicReachPercmetThe number of people who had any content from your Page or about your Page enter their screen through unpaid distribution
% of reach from paidPaidReachPercmetThe number of times any content from your Page or about your Page entered a person's screen through paid distribution such as an ad
% of reach from viralViralReachPercmetThe number of times any content from your Page or about your Page entered a person's screen with social information attached
% of reach from non-viralNonViralReachPercmetThe number of times any content from your Page entered a person's screen
Total reach of postspage_posts_impressions_uniquemetThe number of people who saw any of your Page posts
Paid reach of postspage_posts_impressions_paid_uniquemet
Organic reach of postspage_posts_impressions_organic_uniquemet
Viral reach of postspage_posts_impressions_viral_uniquemet
Non-viral reach of postspage_posts_impressions_nonviral_uniquemet
Reach div. by page likers (fans)FansReachedPercmetReach divided by likes of your page
Viral reach amplification %ViralReachAmplificationmetRate at which your reach was amplified by viral reach
Non-viral reach amplification %NonViralReachAmplificationmetRate at which your reach was amplified by non-viral reach
Post reach (page likers [fans] only)post_impressions_fan_uniquemet
Post impressions (page likers [fans] only)post_impressions_fanmet
ENGAGEMENT & SHARINGPage post engagementspage_post_engagementsmetThe number of times people have engaged with your posts through likes, comments and shares and more
Negative actionspage_negative_feedbackmetThe number of times people took a negative action (e.g., un-liked or hid a post)
People taking negative actionspage_negative_feedback_uniquemetThe number of people who took a negative action (e.g., un-liked or hid a post)
Negative action rate (%)NegativeActionRate_percmetRate of negative actions (eg. unlike, post hide) relative to reach
All clickspage_all_clicksmetTotal number of clicks on all content types in the page such as links, videos, images, etc
Link clickspage_link_clicksmetThe number of clicks, taps, or swipes on links within your content
Other clickspage_other_clicksmetThe number of non-link clicks, taps, or swipes within your content
Photo view clickspage_photo_view_clicksmetThe number of clicks, taps, or swipes on your photo content
Video play clickspage_video_play_clicksmetThe number of clicks, taps, or swipes on your video content
People clicking your contentpage_consumptions_uniquemetThe number of people who clicked on any of your content
POST ACTIONSLikes on postpost_likes_on_postmet
Comments on postpost_comments_on_postmet
Top-level post commentspost_comments_toplevelmet
Shares on postpost_shares_on_postmet
Post link clickspost_link_clicksmet
Post unique link clickspost_link_clicks_uniquemet
Post other clickspost_other_clicksmet
Post unique other clickspost_other_clicks_uniquemet
Post photo viewspost_photo_viewsmet
Post unique photo viewspost_photo_views_uniquemet
Post engaged userspost_engaged_usersmetThe number of people who clicked anywhere in your posts
Post engagement ratePostEngagedUserPercmetPercent of reached people who engaged with your post. Calculated with Post engaged users/Post reach
POST REACTIONSTotal post reactionspost_reactions_totalmetTotal post reactions by type
Post reactions: likepost_reactions_likemetTotal "like" reactions of a post
Post reactions: lovepost_reactions_lovemetTotal "love" reactions of a post
Post reactions: wowpost_reactions_wowmetTotal "wow" reactions of a post
Post reactions: hahapost_reactions_hahametTotal "haha" reactions of a post
Post reactions: sadpost_reactions_sorrymetTotal "sorry" reactions of a post
Post reactions: angrypost_reactions_angermetTotal "anger" reactions of a post
Post reactions: thankfulpost_reactions_thankfulmet
Post reactions: pridepost_reactions_pridemet
CONTENT IMPRESSIONSTotal page viewspage_viewsmetNumber of times any tabs (e.g. Timeline, photo) of page's profile has been visited
Total impressionspage_impressionsmetThe total number of impressions seen of any content associated with your Page
Paid impressionspage_impressions_paidmetThe number of impressions of a Sponsored Story or Ad pointing to your Page
Organic impressionspage_impressions_organicmetThe number of times people saw any unpaid content from your Page or about your Page in News Feed or on visits to your Page
Viral impressionspage_impressions_viralmetThe number of impressions of a story published by a friend about your Page. These stories include liking your Page, posting to your Page's Timeline, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
Non-viral impressionspage_impressions_nonviralmetThe number of times your Page's posts entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Total impressions of postspage_posts_impressionsmetThe number of times your Page's posts entered a person's screen. Posts include statuses, photos, links, videos and more
Paid impressions of postspage_posts_impressions_paidmetThe number of times your Page's posts entered a person's screen through paid distribution such as an ad
Organic impressions of postspage_posts_impressions_organicmetThe number of times your Page's posts entered a person's screen through unpaid distribution
Viral impressions of postspage_posts_impressions_viralmetThe number of times your Page's posts entered a person's screen with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Non-viral impressions of postspage_posts_impressions_nonviralmetThe number of times your Page's posts entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
VIDEO VIEWSOrganic complete video viewspost_video_complete_views_organicmetThe number of times your videos played from the beginning to 95%, or more, of its length, by organic reach
Unique organic complete video viewspost_video_complete_views_organic_uniquemetThe number of people who viewed your videos from the beginning to 95%, or more, of its length, by organic reach
Paid complete video viewspost_video_complete_views_paidmetThe number of times your promoted videos played from the beginning to 95%, or more, of its length
Unique paid complete video viewspost_video_complete_views_paid_uniquemetThe number of people who viewed your promoted videos from the beginning to 95%, or more, of its length
Total video viewspage_video_viewsmetTotal number of times page's videos have been viewed for more than 3 seconds
Unique video viewspage_video_views_uniquemetTotal number of times page's videos have been played for unique people for more than 3 seconds
Organic video viewspage_video_views_organicmetTotal number of times page's videos have been viewed for more than 3 seconds by organic reach
Paid video viewspage_video_views_paidmetTotal number of times page's promoted videos have been viewed for more than 3 seconds
Auto-played video viewspage_video_views_autoplayedmetThe number of times your videos automatically played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds
Clicked to play video viewspage_video_views_click_to_playmetThe number of times your videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, after people clicked play
Total video views with sound onpost_video_views_sound_onmetNumber of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first
Total video view time (s)post_video_view_timemetThe total number of seconds your video was watched, including replays and views less than 3 seconds. Returns 0 for reshared videos
Organic video view time (s)post_video_view_time_organicmetThe total time, in milliseconds, your videos played by organic reach. Returns 0 for reshared videos
Paid video view time (s)post_video_view_time_paidmetThe number of times your promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds
Avg. video view time (s)avg_post_video_view_timemetThe average time, in milliseconds, people viewed your videos. Only available for videos created after August 25th 2016
Total 60s video viewspost_video_views_60s_excludes_shortermetThe number of times your videos played for at least 60 seconds. This metric is counted only for videos that are 60 seconds or longer
Total 15s video viewspost_video_views_15smetThe number of times your videos played for at least 15 seconds, or for nearly their total length if they're shorter than 15 seconds
VIDEO 30-SECOND VIEWSTotal 30s video viewspage_video_complete_views_30smetTotal number of times page's videos have been viewed for more than 30 seconds
Unique 30s video viewspage_video_complete_views_30s_uniquemetThe number of people who viewed your Page's videos for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Organic 30s video viewspage_video_complete_views_30s_organicmetThe number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, by organic reach
Paid 30s video viewspage_video_complete_views_30s_paidmetThe number of times your Page's promoted videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Auto-played 30s video viewspage_video_complete_views_30s_autoplayedmetThe number of times your Page's automatically played videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Clicked to play 30s video viewspage_video_complete_views_30s_click_to_playmetThe number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, after people clicked play
Watch 30s rate (%)page_video_watch_30s_rate_percmet
Unique watch 30s rate (%)page_video_watch_30s_rate_unique_percmet
Organic watch 30s rate (%)page_video_watch_30s_rate_organic_percmet
Paid watch 30s rate (%)page_video_watch_30s_rate_paid_percmet
Auto-played watch 30s rate (%)page_video_watch_30s_rate_autoplayed_percmet
Clicked to play watch 30s rate (%)page_video_watch_30s_rate_click_to_play_percmet
VIDEO AD BREAKPage crossposted video ad break impressionspage_daily_video_ad_break_ad_impressions_crosspostedmetThe total number of times an ad was shown during ad breaks in crossposted videos
Page crossposted video ad break earningspage_daily_video_ad_break_earnings_crosspostedmetThe average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook
Page crossposted video ad break CPMpage_daily_video_ad_break_cpm_crosspostedmetAn estimate of the amount you earned from ad breaks in crossposted videos, based on the number of impressions and CPM of ads shown
Page owned video ad break impressionspage_daily_video_ad_break_ad_ownedmetThe total number of times an ad was shown during ad breaks in owned videos
Page owned video ad break earningspage_daily_video_ad_break_earnings_ownedmetThe average amount paid by advertisers for 1,000 of impressions of their ads in a owned videos. This is a gross number and includes the amount paid to Facebook
Page owned video ad break CPMpage_daily_video_ad_break_cpm_ownedmetAn estimate of the amount you earned from ad breaks in owned videos, based on the number of impressions and CPM of ads shown
Post video ad break impressionspost_video_ad_break_ad_impressionsmetThe total number of times an ad was shown during ad breaks in your videos
Post video ad break earningspost_video_ad_break_earningsmetThe average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook
Post video ad break CPMpost_video_ad_break_ad_cpmmetAn estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown
VIDEO AD BREAK (VIDEO-DIMENSIONS ONLY)Total video ad break impressionstotal_video_ad_break_ad_impressionsmetNumber of times an ad was shown during your video's ad breaks
Total video ad break CPMtotal_video_ad_break_ad_cpmmetThe average amount paid by advertisers for 1,000 impressions of their ads in your video, in U.S. cents. This number also includes the amount paid to Facebook
Total video ad break earningstotal_video_ad_break_earningsmetAn estimate of the amount you earned from ad breaks in your video, in U.S. cents, based on the number of impressions and CPM of ads shown
VIDEO REACTIONS (VIDEO-DIMENSIONS ONLY)Total video reactionsvideo_reactions_totalmet
Video reactions: likevideo_reactions_likemet
Video reactions: lovevideo_reactions_lovemet
Video reactions: wowvideo_reactions_wowmet
Video reactions: hahavideo_reactions_hahamet
Video reactions: sadvideo_reactions_sorrymet
Video reactions: angryvideo_reactions_angermet
Video reactions: thankfulvideo_reactions_thankfulmet
Video reactions: pridevideo_reactions_pridemet
REELSReels playsreels_blue_reels_play_countmetThe number of times your reel starts to play after an impression is already counted. This metric counts reels sessions with 1 millisecond or more of playback. This metric excludes replays
Reels reachreels_impressions_uniquemetThe number of people who saw your reel at least once, whether or not the person played your reel. This metric is different from impressions, which includes multiple views of your reel by the same person. This metric is estimated
Reels avg. time watchedreel_video_avg_time_watchedmetThe average number of milliseconds your reel was played during a single instance of playing it, including time spent replaying your reel. Because this metric includes replays, the value can be greater than the total length of the reel
Reels total reactionstotal_reel_video_reactionsmetTotal reels reactions by type
Reels reactions: likereel_video_likes_by_reaction_type_likemetThe number of reactions (likes) on your reel
Reels reactions: lovereel_video_likes_by_reaction_type_lovemetThe number of reactions (love) on your reel
Reels reactions: carereel_video_likes_by_reaction_type_caremetThe number of reactions (care) on your reel
Reels reactions: hahareel_video_likes_by_reaction_type_hahametThe number of reactions (haha) on your reel
Reels reactions: wowreel_video_likes_by_reaction_type_wowmetThe number of reactions (wow) on your reel
Reels reactions: sadreel_video_likes_by_reaction_type_sadmetThe number of reactions (sad) on your reel
Reels reactions: angryreel_video_likes_by_reaction_type_angrymetThe number of reactions (angry) on your reel
Reels sharesreel_video_social_actions_sharemetThe number of times your reel was shared
Reels commentsreel_video_social_actions_commentmetThe number of comments on your reel
Reels total view timereel_video_view_timemetThe total number of milliseconds your reel played, including time spent replaying your reel
CHECK-INSCheck-inspage_places_checkin_totalmetThe number of times people checked into a place
People checking inpage_places_checkin_total_uniquemetThe number of people who checked into a place
REVIEWS/RECOMMENDATIONSRatingreview_ratingmetRating (1-5 stars)
MESSAGING INSIGHTSMessaging connection countpage_messages_total_messaging_connectionsmetThe number of people who have sent a message to your business, not including people who have blocked or reported your business on Messenger
New conversations (unique)page_messages_new_conversations_uniquemetThe number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before
Blocked conversations count (unique)page_messages_blocked_conversations_uniquemetThe number of conversations with the Page that have been blocked
Reported conversations count (unique)page_messages_reported_conversations_uniquemetThe number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content
DEPRECATEDCheck-ins using mobilepage_places_checkin_mobilemetThe number of times people checked into a place using mobile phones. Please note that this field will be removed on 2024-03-14
Auto-played watch 10s rate (%)post_video_watch_10s_rate_autoplayed_percmetPlease note that this field will be removed on 2024-04-18
Sharespage_sharesmetPlease note that this field will be removed on 2024-03-14
People taking positive actionspage_positive_feedback_uniquemetPlease note that this field will be removed on 2024-03-14
Likespage_likesmetThe number of times people took the positive feedback action to like a story or post on the page. Please note that this field will be removed on 2024-03-14
Positive actionspage_positive_feedbackmetThe number of times people took a positive action. Please note that this field will be removed on 2024-03-14
Engagement rate (% of reached people who clicked)EngagedUserPercmetPercent of reached people who engaged with your page or post. Please note that this field will be removed on 2024-03-14
Engaged userspage_engaged_usersmetThe number of people who engaged with your Page. Engagement includes any click. Please note that this field will be removed on 2024-03-14
Commentspage_commentsmetPlease note that this field will be removed on 2024-03-14
Content clickspage_consumptionsmetThe number of times people clicked on any of your content. Please note that this field will be removed on 2024-03-14
Content storiespage_storiesmetThe number of stories created about your Page (Stories). Please note that this field will be removed on 2024-03-14
Likes on post sharespost_likes_on_sharesmetPlease note that this field will be removed on 2024-03-14
Comments on post sharespost_comments_on_sharesmetPlease note that this field will be removed on 2024-03-14
People visiting your pagepage_views_uniquemetPage Views from users logged in to Facebook. Please note that this field will be removed on 2024-03-14
Shares on post sharespost_shares_on_sharesmetPlease note that this field will be removed on 2024-03-14
Clicked to play watch 10s rate (%)post_video_watch_10s_rate_click_to_play_percmetPlease note that this field will be removed on 2024-04-18
Total 10s video viewspost_video_views_10smetThe number of times your video was watched for an aggregate of at least 10 seconds, or for nearly its total length, whichever happened first. Returns 0 for reshared videos. Please note that this field will be removed on 2024-04-18
People checking in using mobilepage_places_checkin_mobile_uniquemetThe number of people who checked into a place using mobile phones. Please note that this field will be removed on 2024-03-14
Unique 10s video viewspost_video_views_10s_uniquemetThe number of people who viewed your Page's videos for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds. Please note that this field will be removed on 2024-04-18
Organic 10s video viewspost_video_views_10s_organicmetThe number of times your Page's videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds, by organic reach. Please note that this field will be removed on 2024-04-18
Paid 10s video viewspost_video_views_10s_paidmetThe number of times your Page's promoted videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds. Please note that this field will be removed on 2024-04-18
Auto-played 10s video viewspost_video_views_10s_autoplayedmetThe number of times your Page's videos automatically played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds. Please note that this field will be removed on 2024-04-18
Clicked to play 10s video viewspost_video_views_10s_click_to_playmetThe number of times your Page's videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds, after people clicked play. Please note that this field will be removed on 2024-04-18
10s video views with sound onpost_video_views_10s_sound_onmetPlease note that this field will be removed on 2024-04-18
Watch 10s rate (%)post_video_watch_10s_rate_percmetPlease note that this field will be removed on 2024-04-18
Unique watch 10s rate (%)post_video_watch_10s_rate_unique_percmetPlease note that this field will be removed on 2024-04-18
Organic watch 10s rate (%)post_video_watch_10s_rate_organic_percmetPlease note that this field will be removed on 2024-04-18
Paid watch 10s rate (%)post_video_watch_10s_rate_paid_percmetPlease note that this field will be removed on 2024-04-18