Field list for Facebook Insights

18 metrics and 53 dimensions available

CategoryFieldCodeTypeDescription
TIMEYearYeardimYear, e.g. 2017
Year & monthYearmonthdimYear and month, e.g. 2017|06
Year & week (Mon-Sun)YearweekdimYear and week for US weeks, e.g. 2017|08
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
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 video length (s)post_video_lengthdim
Post creation time of daypost_created_time_of_daydim
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
OTHERContent click typeconsumption_typedim
Action typefeedback_typedim
Page like sourcelike_sourcedim
Story typestory_typedim
Page tabtabdim
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.
New likes (unique users)page_fan_adds_uniquemetThe number of new people who have liked your Page.
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 rateFanGrowthRate_percmetGrowth rate of your page likes.
Likes churn rateFanChurnRate_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
People visiting your pagepage_views_uniquemetPage Views from users logged in to Facebook.
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 & SHARINGEngaged userspage_engaged_usersmetThe number of people who engaged with your Page. Engagement includes any click.
Engagement rate (% of reached people who clicked)EngagedUserPercmetPercent of reached people who engaged with your page or post
Positive actionspage_positive_feedbackmetThe number of times people took a positive action.
People taking positive actionspage_positive_feedback_uniquemet
Page post engagementspage_post_engagementsmetThe number of times people have engaged with your posts through likes, comments and shares and more.
Likespage_likesmet
Sharespage_sharesmet
Commentspage_commentsmet
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 (% of reached people who took negative action)NegativeActionRate_percmetRate of negative actions (eg. unlike, post hide) relative to reach
Content clickspage_consumptionsmetThe number of times people clicked on any of your content.
People clicking your contentpage_consumptions_uniquemetThe number of people who clicked on any of your content.
Content storiespage_storiesmetThe number of stories created about your Page (Stories)
POST ACTIONSLikes on postpost_likes_on_postmet
Likes on post sharespost_likes_on_sharesmet
Comments on postpost_comments_on_postmet
Comments on post sharespost_comments_on_sharesmet
Top-level post commentspost_comments_toplevelmet
Shares on postpost_shares_on_postmet
Shares on post sharespost_shares_on_sharesmet
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 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 VIEWSTotal 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.
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 (%)video_watch_30s_rate_percmet
Unique watch 30s rate (%)video_watch_30s_rate_unique_percmet
Organic watch 30s rate (%)video_watch_30s_rate_organic_percmet
Paid watch 30s rate (%)video_watch_30s_rate_paid_percmet
Auto-played watch 30s rate (%)video_watch_30s_rate_autoplayed_percmet
Clicked to play watch 30s rate (%)video_watch_30s_rate_click_to_play_percmet
VIDEO 10-SECOND VIEWSTotal 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.
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.
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.
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.
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.
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.
10s video views with sound onpost_video_views_10s_sound_onmet
Watch 10s rate (%)post_video_watch_10s_rate_percmet
Unique watch 10s rate (%)post_video_watch_10s_rate_unique_percmet
Organic watch 10s rate (%)post_video_watch_10s_rate_organic_percmet
Paid watch 10s rate (%)post_video_watch_10s_rate_paid_percmet
Auto-played watch 10s rate (%)post_video_watch_10s_rate_autoplayed_percmet
Clicked to play watch 10s rate (%)post_video_watch_10s_rate_click_to_play_percmet
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
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.
Check-ins using mobilepage_places_checkin_mobilemetThe number of times people checked into a place using mobile phones.
People checking in using mobilepage_places_checkin_mobile_uniquemetThe number of people who checked into a place using mobile phones.