Last updated: October 1, 2026
49 dimensions
86 metrics
Supported destinations:
Google Sheets
Looker Studio
Claude
BigQuery
Dimensions
Dimensions are the attributes you can use to segment and group your Facebook Insights data.Page
Page ID | The unique identifier of the page Field Name: pageIdType: dimension |
Page Name | The name of the page Field Name: pageNameType: dimension |
Page Link | The URL link to the page Field Name: pageLinkType: dimension |
Page Category | The category of the page Field Name: pageCategoryType: dimension |
Page Description | The description of the page Field Name: pageDescriptionType: dimension |
Page About | The about section of the page Field Name: pageAboutType: dimension |
Page Phone | The phone number of the page Field Name: pagePhoneType: dimension |
Page Website | The website URL of the page Field Name: pageWebsiteType: dimension |
Page Hours | The business hours of the page Field Name: pageHoursType: dimension |
Page City | The city where the page is located Field Name: pageCityType: dimension |
Page Country | The country where the page is located Field Name: pageCountryType: dimension |
Page Emails | The email addresses of the page Field Name: pageEmailsType: dimension |
Page Picture | The profile picture URL of the page Field Name: pagePictureType: dimension |
Page Is Published | Whether the page is published Field Name: pageIsPublishedType: dimension |
Post
Post ID | The unique identifier of the post Field Name: postIdType: dimension |
Post Message | The message content of the post Field Name: postMessageType: dimension |
Post Created Time | The time the post was created Field Name: postCreatedTimeType: dimension |
Post Permalink URL | The permanent link URL to the post Field Name: postPermalinkUrlType: dimension |
Post Status Type | The type of status update (e.g. mobile_status_update, added_photos, added_video) Field Name: postStatusTypeType: dimension |
Post Author Name | The name of the user or page that created the post Field Name: postFromNameType: dimension |
Post Author ID | The ID of the user or page that created the post Field Name: postFromIdType: dimension |
Post Full Picture URL | The full-sized picture URL attached to the post Field Name: postFullPictureType: dimension |
Post Attachment Type | The type of attachment (e.g. photo, video, link) Field Name: postAttachmentTypeType: dimension |
Post Attachment URL | The URL of the attachment Field Name: postAttachmentUrlType: dimension |
Post Attachment Description | The description of the attachment Field Name: postAttachmentDescriptionType: dimension |
Media Product Type | The type of content: REEL, PHOTO, ALBUM, or VIDEO. Derived from the post permalink and attachment type Field Name: postMediaProductTypeType: dimension |
Post Video ID | The video ID for video posts. Empty for non-video posts. Use this to join with video-level data Field Name: postVideoIdType: dimension |
Post Is Published | Whether the post is published Field Name: postIsPublishedType: dimension |
Post Is Hidden | Whether the post is hidden from timeline Field Name: postIsHiddenType: dimension |
Post Is Expired | Whether the post has expired Field Name: postIsExpiredType: dimension |
Post Comment
Comment ID | The unique identifier of the comment Field Name: postCommentIdType: dimension |
Comment Text | The comment text Field Name: postCommentTextType: dimension |
Comment Author | Author of the comment Field Name: postCommentAuthorType: dimension |
Comment Date | Date of the comment Field Name: postCommentDateType: dimension |
Comment Time | Time of the comment Field Name: postCommentTimeType: dimension |
Followers Demographics
Followers City | City where followers are located. Auto-added when using the Followers Count by City metric Field Name: followersCityType: dimension |
Followers Country | Country code where followers are located (e.g. AR, US, BR). Auto-added when using the Followers Count by Country metric Field Name: followersCountryType: dimension |
Video Demographics
Viewer Gender | Viewer gender (Female, Male, Unknown). Auto-added when using the Video View Time by Age & Gender metric Field Name: videoGenderType: dimension |
Viewer Age | Viewer age bucket (13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+). Auto-added when using the Video View Time by Age & Gender metric Field Name: videoAgeBucketType: dimension |
Video Regions
Viewer Region | Viewer region and country (e.g. “British Columbia - Canada”). Auto-added when using the Video View Time by Region metric Field Name: videoRegionType: dimension |
Video Retention
Video Second | Second offset into the video (0, 1, 2, …). Auto-added when using the Video Retention metrics — one row per second of the video Field Name: videoSecondType: dimension |
Video Distribution
Distribution Type | How the video reached viewers: page_owned (posted by your Page), shared, or crossposted. Auto-added when using the Video Views by Distribution metric Field Name: videoDistributionTypeType: dimension |
Lead
Lead ID | The unique identifier of the lead Field Name: leadIdType: dimension |
Form ID | The ID of the lead form Field Name: formIdType: dimension |
Form Name | The name of the lead form Field Name: formNameType: dimension |
Lead Created Time | The time the lead was created Field Name: leadCreatedTimeType: dimension |
Lead Ad ID | The ID of the ad that generated the lead Field Name: leadAdIdType: dimension |
Lead Field Name | The field name from the lead form Field Name: leadNameType: dimension |
Lead Field Value | The field value submitted in the lead form Field Name: leadValueType: dimension |
Metrics
Metrics are the numerical values you can measure and analyze from your Facebook Insights campaigns.Page Posts
Organic Impressions of Posts | The number of times your Page’s posts entered a person’s screen through organic distribution Field Name: page_posts_impressions_organicType: metric |
Page Engagement
Page Post Engagements | The number of times people have engaged with your posts through likes, comments and shares and more Field Name: page_post_engagementsType: metric |
Engaged Followers (Unique) | The number of unique followers of your Page who engaged with it in the selected period Field Name: page_lifetime_engaged_followers_uniqueType: metric |
Page Total Actions | The number of clicks on your Page’s contact info and call-to-action button Field Name: page_total_actionsType: metric |
Page
Page Fan Count | The number of fans (likes) on the page. Returns a single snapshot of the current count. For historical daily tracking, use Page Followers instead Field Name: pageFanCountType: metric |
Page Followers | The total number of followers of your Facebook Page (follows minus unfollows). Available as a daily time series to track follower growth over time Field Name: page_followsType: metric |
New Followers | The number of new follows of your Page in the selected period. Successor of the deprecated Page Fan Adds metric Field Name: page_daily_followsType: metric |
New Followers (Unique) | The number of unique people who followed your Page in the selected period Field Name: page_daily_follows_uniqueType: metric |
Unfollows (Unique) | The number of unique people who unfollowed your Page in the selected period. Successor of the deprecated Page Fan Removes metric Field Name: page_daily_unfollows_uniqueType: metric |
Page Views
Page Visits | The number of times a Page’s profile has been viewed by logged in and logged out people Field Name: page_views_totalType: metric |
Page Media Views | The number of times your content was played or displayed. Content includes videos, posts, stories and ads Field Name: page_media_viewType: metric |
Page Media Views Paid | The number times paid distribution such as ads promoting your page was played or displayed Field Name: page_media_view_paidType: metric |
Page Media Views Organic | The number of times your organic content was played or displayed. Content includes videos, posts, stories Field Name: page_media_view_organicType: metric |
Page Media Views Followers | The number of times your content was played by or displayed to page followers Field Name: page_media_view_followersType: metric |
Page Media Views Non-Followers | The number of times your content was played by or displayed to non-followers Field Name: page_media_view_non_followersType: metric |
Page Media Viewers | The number of unique people who viewed any content from your Page. Meta’s successor to the deprecated Reach metric — values may differ slightly from historical Reach as counting is now based on views rendered on screen Field Name: page_total_media_view_uniqueType: metric |
Followers Demographics
Followers Count by City | Lifetime follower count broken down by city. Each city becomes a separate row with the followersCity dimension auto-added Field Name: page_follows_cityType: metric |
Followers Count by Country | Lifetime follower count broken down by country. Each country becomes a separate row with the followersCountry dimension auto-added Field Name: page_follows_countryType: metric |
Page Reactions
Page Reactions: Like | Daily total post “like” reactions of a page Field Name: page_actions_post_reactions_like_totalType: metric |
Page Reactions: Love | Daily total post “love” reactions of a page Field Name: page_actions_post_reactions_love_totalType: metric |
Page Reactions: Wow | Daily total post “wow” reactions of a page Field Name: page_actions_post_reactions_wow_totalType: metric |
Page Reactions: Haha | Daily total post “haha” reactions of a page Field Name: page_actions_post_reactions_haha_totalType: metric |
Page Reactions: Sorry | Daily total post “sorry” reactions of a page Field Name: page_actions_post_reactions_sorry_totalType: metric |
Page Reactions: Anger | Daily total post “anger” reactions of a page Field Name: page_actions_post_reactions_anger_totalType: metric |
Page Video
Total Video Views | Total number of times page’s videos have been viewed for more than 3 seconds Field Name: page_video_viewsType: metric |
Unique Video Views | Total number of times page’s videos have been played for unique people for more than 3 seconds Field Name: page_video_views_uniqueType: metric |
Organic Video Views | Total number of times page’s videos have been viewed for more than 3 seconds by organic reach Field Name: page_video_views_organicType: metric |
Paid Video Views | Total number of times page’s promoted videos have been viewed for more than 3 seconds Field Name: page_video_views_paidType: metric |
Auto-Played Video Views | The number of times your videos automatically played for at least 3 seconds Field Name: page_video_views_autoplayedType: metric |
Clicked to Play Video Views | The number of times your videos played for at least 3 seconds after people clicked play Field Name: page_video_views_click_to_playType: metric |
Total Video View Time (ms) | The total time, in milliseconds, that your Page’s videos played, including videos played for less than 3 seconds and replays Field Name: page_video_view_timeType: metric |
Repeat Video Views | The number of times your Page’s videos replayed for at least 3 seconds after starting to play again in the same session Field Name: page_video_repeat_viewsType: metric |
Page Video 30s
Total 30s Video Views | Total number of times page’s videos have been viewed for more than 30 seconds Field Name: page_video_complete_views_30sType: metric |
Unique 30s Video Views | The number of people who viewed your Page’s videos for at least 30 seconds Field Name: page_video_complete_views_30s_uniqueType: metric |
Organic 30s Video Views | The number of times your Page’s videos played for at least 30 seconds by organic reach Field Name: page_video_complete_views_30s_organicType: metric |
Paid 30s Video Views | The number of times your Page’s promoted videos played for at least 30 seconds Field Name: page_video_complete_views_30s_paidType: metric |
Auto-Played 30s Video Views | The number of times your Page’s automatically played videos played for at least 30 seconds Field Name: page_video_complete_views_30s_autoplayedType: metric |
Clicked to Play 30s Video Views | The number of times your Page’s videos played for at least 30 seconds after people clicked play Field Name: page_video_complete_views_30s_click_to_playType: metric |
Messaging
New Conversations (Unique) | The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before Field Name: page_messages_new_conversations_uniqueType: metric |
Blocked Conversations Count (Unique) | The number of conversations with the Page that have been blocked Field Name: page_messages_blocked_conversations_uniqueType: metric |
Reported Conversations Count (Unique) | The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content Field Name: page_messages_reported_conversations_uniqueType: metric |
Post Actions
Post Total Clicks | The number of times people clicked on anywhere in your posts without generating a story Field Name: post_clicksType: metric |
Post Link Clicks | The number of link clicks on the post from post_clicks_by_type Field Name: postLinkClicksType: metric |
Post Other Clicks | The number of other clicks on the post from post_clicks_by_type Field Name: postOtherClicksType: metric |
Post Photo Views | The number of photo views on the post from post_clicks_by_type Field Name: postPhotoViewsType: metric |
Likes on Post | The number of likes on the post from post_activity_by_action_type Field Name: postLikesOnPostType: metric |
Comments on Post | The number of comments on the post from post_activity_by_action_type Field Name: postCommentsOnPostType: metric |
Shares on Post | The number of shares on the post from post_activity_by_action_type Field Name: postSharesOnPostType: metric |
Post Reactions
Total Post Reactions | Total post reactions by type Field Name: postReactionsTotalType: metric |
Total Post Comments | Total comments on the post Field Name: postCommentsTotalType: metric |
Post Reactions: Like | Total “like” reactions of a post Field Name: postReactionsLikeType: metric |
Post Reactions: Love | Total “love” reactions of a post Field Name: postReactionsLoveType: metric |
Post Reactions: Wow | Total “wow” reactions of a post Field Name: postReactionsWowType: metric |
Post Reactions: Haha | Total “haha” reactions of a post Field Name: postReactionsHahaType: metric |
Post Reactions: Sad | Total “sad” reactions of a post Field Name: postReactionsSadType: metric |
Post Reactions: Angry | Total “angry” reactions of a post Field Name: postReactionsAngryType: metric |
Post Reactions: Thankful | Total “thankful” reactions of a post Field Name: postReactionsThankfulType: metric |
Post Reactions: Pride | Total “pride” reactions of a post Field Name: postReactionsPrideType: metric |
Post Reactions: Care | Total “care” reactions of a post Field Name: postReactionsCareType: metric |
Post Views
Post Media Viewers | The number of unique people who viewed media on this post. Meta’s successor to the deprecated Post Reach metric Field Name: post_total_media_view_uniqueType: metric |
Post Media Views | The number of times media on this post was played or displayed. Post-level counterpart of Page Media Views, and Meta’s successor to the deprecated Post Impressions metric Field Name: post_media_viewType: metric |
Post Video
Total Post Video Views | The number of times your video was viewed for 3 seconds or more Field Name: post_video_viewsType: metric |
Organic Post Video Views | The number of times your video was viewed for 3 seconds or more by organic reach Field Name: post_video_views_organicType: metric |
Paid Post Video Views | The number of times your promoted video was viewed for 3 seconds or more Field Name: post_video_views_paidType: metric |
Unique Post Video Views | The number of unique people who viewed your video for 3 seconds or more Field Name: post_video_views_uniqueType: metric |
Autoplayed Post Video Views | The number of times your video was auto-played and viewed for 3 seconds or more Field Name: post_video_views_autoplayedType: metric |
Clicked-to-Play Post Video Views | The number of times a user clicked to play your video and viewed it for 3 seconds or more Field Name: post_video_views_clicked_to_playType: metric |
Organic Complete Video Views | The number of times your videos played from the beginning to 95%, or more, of its length, by organic reach Field Name: post_video_complete_views_organicType: metric |
Unique Organic Complete Video Views | The number of people who viewed your videos from the beginning to 95%, or more, of its length, by organic reach Field Name: post_video_complete_views_organic_uniqueType: metric |
Paid Complete Video Views | The number of times your promoted videos played from the beginning to 95%, or more, of its length Field Name: post_video_complete_views_paidType: metric |
Unique Paid Complete Video Views | The number of people who viewed your promoted videos from the beginning to 95%, or more, of its length Field Name: post_video_complete_views_paid_uniqueType: metric |
Total Video Views with Sound On | Number of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first Field Name: post_video_views_sound_onType: metric |
Organic Video View Time (s) | The total time, in milliseconds, your videos played by organic reach. Returns 0 for reshared videos Field Name: post_video_view_time_organicType: metric |
Paid Video View Time (s) | The number of times your promoted videos played for at least 3 seconds, or for nearly their total length if they are shorter than 3 seconds Field Name: post_video_view_time_paidType: metric |
Total Post Video View Time (ms) | The total time, in milliseconds, your video played, including replays and views under 3 seconds. Organic plus paid Field Name: post_video_view_timeType: metric |
Avg Video Time Watched (ms) | The average time, in milliseconds, people spent watching your video. Compare against Video Length to measure completion quality Field Name: post_video_avg_time_watchedType: metric |
Video Length (ms) | The duration of the post video in milliseconds Field Name: post_video_lengthType: metric |
Total 60s Video Views | The number of times your videos played for at least 60 seconds. This metric is counted only for videos that are 60 seconds or longer Field Name: post_video_views_60s_excludes_shorterType: metric |
Total 15s Video Views | The number of times your videos played for at least 15 seconds, or for nearly their total length if they are shorter than 15 seconds Field Name: post_video_views_15sType: metric |
Video Demographics
Video View Time by Age & Gender (ms) | Total video view time in milliseconds broken down by viewer age bucket and gender. Each combination becomes a separate row with the Viewer Gender and Viewer Age dimensions auto-added Field Name: post_video_view_time_by_age_bucket_and_genderType: metric |
Video Regions
Video View Time by Region (ms) | Total video view time in milliseconds broken down by viewer region. Each region becomes a separate row with the Viewer Region dimension auto-added Field Name: post_video_view_time_by_region_idType: metric |
Video Retention
Video Retention | Fraction of viewers (0–1) still watching at each second of the video. One row per second with the Video Second dimension auto-added — chart it to see where viewers drop off Field Name: post_video_retention_graphType: metric |
Video Retention (Auto-Played) | Fraction of viewers (0–1) still watching at each second, counting only auto-played views. Combinable with the other Video Retention metrics on the same rows Field Name: post_video_retention_graph_autoplayedType: metric |
Video Retention (Clicked to Play) | Fraction of viewers (0–1) still watching at each second, counting only clicked-to-play views. Combinable with the other Video Retention metrics on the same rows Field Name: post_video_retention_graph_clicked_to_playType: metric |
Video Distribution
Video Views by Distribution | Video views broken down by how the video reached viewers (page_owned, shared, crossposted). Each type becomes a separate row with the Distribution Type dimension auto-added Field Name: post_video_views_by_distribution_typeType: metric |
Lead
Form Leads Count | The number of leads collected by the form Field Name: formLeadsCountType: metric |
Related
Fields Catalog
Browse all platforms
Instagram Insights Fields
Instagram Insights metrics & dimensions
Facebook Public Data Fields
Facebook Public Data metrics & dimensions
TikTok Organic Fields
TikTok Organic metrics & dimensions