Facebook Page Insights: Most-used fields
The table below gives information about most-used fields that you can import from Facebook Page Insights. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
Actions Post Reactions (Total)Metric
The total number of reactions (like, love, haha, wow, sad, angry) on your posts.
Actions Post Reactions: ANGER (Total)Metric
The total number of 'Angry' reactions on your posts.
Actions Post Reactions: HAHA (Total)Metric
The total number of 'Haha' reactions on your posts.
Actions Post Reactions: LIKE (Total)Metric
The total number of 'Like' reactions on your posts.
Actions Post Reactions: LOVE (Total)Metric
The total number of 'Love' reactions on your posts.
Actions Post Reactions: SORRY (Total)Metric
The total number of 'Sad' reactions on your posts.
Actions Post Reactions: WOW (Total)Metric
The total number of 'Wow' reactions on your posts.
AnswersMetric
The number of stories created about your Page post from people answering a question.
Answers (Unique)Metric
The number of unique people who created a story about your Page post from answering a question.
Breakdown TypeDimension
The category used to segment insights data, such as age, gender, or country.
Breakdown ValueDimension
The specific value within a breakdown category (e.g., '18-24' for age, 'Male' for gender).
COMMENTReel Social Actions (COMMENT)Metric
The total number of comments on a Facebook Reel. This metric provides insight into user engagement with the Reel content.
Check-InsDimension
The number of check-ins to your Page's location or an event associated with your Page.
Check-Ins (Unique)Dimension
The number of unique people who checked into your Page's location or an event associated with your Page.
CityDimension
Demographic breakdown of users or fans by city.
ClicksMetric
The total number of clicks on your Page or its content, including links, photos, videos, and call-to-action buttons.
Clicks (Unique)Metric
The number of unique people who clicked anywhere in your posts without generating a story.
CommentsMetric
The total number of comments on your Page's posts.
Comments (Unique)Metric
The number of unique users who commented on your Page's posts.
ConsumptionsMetric
The total number of times people engaged with your content by clicking on it, viewing photos, playing videos, or interacting with links.
Consumptions (Unique)Metric
The number of unique users who performed any action or interaction related to the content on your Facebook Page. This includes actions such as clicks on posts, photo views, link clicks, or other forms of content consumption. Metrics with a '_unique' suffix indicate unique users and are approximate.
CountryDimension
Demographic breakdown of users or fans by country.
DateDimension
The date for which the insights data is reported.
Engaged UsersMetric
The number of people who have engaged with your content.
Event (RSVP)Dimension
The number of RSVPs to events associated with your Page.
Fan (Page likes)Metric
The total number of people who have liked or followed your Page.
Fan (Page likes) (Unique)Metric
The number of unique Accounts Center accounts that liked your Page for the first time.
Fan AddsMetric
The number of new users who liked your Facebook Page within the reporting period.
Fan Adds by Paid/Non Paid (Unique)Metric
The number of unique new users who liked your Facebook Page, categorized by whether the like originated from paid or unpaid (organic) efforts.
Fan RemovesMetric
The number of users who unliked your Facebook Page within the reporting period.
Fans by CityMetric
The distribution of your Facebook Page followers by city.
Fans by CountryMetric
The distribution of your Facebook Page followers by country.
Fans by Like Source (Unique)Metric
The number of unique Accounts Center accounts that liked your Page for the first time, broken down by the source from which the like originated (e.g., Ads, News Feed, Page Suggestions, Search, Your Page).
FollowsMetric
The total number of users who follow your Facebook Page.
IDMetric
A unique identifier for the Facebook object (e.g., page, post, video, comment) from which the data is collected.
ImpressionsMetric
The total number of times any content from your Facebook Page, or content about your Page, was displayed on someone's screen.
Impressions (Organic)Metric
The number of times your Page content or content about your Page was displayed on screen through unpaid distribution.
Impressions (Paid)Metric
The number of times your Page content or content about your Page was displayed on screen through paid distribution, such as advertisements.
Impressions FanMetric
The total number of times any of your Page's fans saw your posts on Facebook.
Like SourceDimension
The source from which a Page like originated, such as Ads, News Feed, Page Suggestions, or Search.
LikesMetric
The total number of 'Like' reactions on your Page's posts, photos, or videos.
Likes (Unique)Metric
The number of unique users who applied a 'Like' reaction to your Page's posts, photos, or videos.
Link ClicksMetric
The total number of times users clicked on links in your Page's posts or on the Page itself.
Link Clicks (Unique)Metric
The number of unique people who clicked on a link within your posts.
LinksMetric
The number of times people clicked on links within your Page's content.
Links (Unique)Metric
The number of unique people who clicked on links within your Page's content.
MentionsDimension
The number of times your Page was tagged or mentioned in posts.
Mentions (Unique)Dimension
The number of unique people who tagged or mentioned your Page in posts.
MessageDimension
The textual content of a post or comment. This field captures the actual message body associated with user-generated content or page posts.
NameDimension
This field represents the name or title of the Facebook entity (e.g., Page, Post, Video, or Reel) for which insights are being collected. It serves as an identifier for the specific object the insights data pertains to.
Negative FeedbackMetric
The number of negative feedback actions, such as hiding posts or reporting spam.
New FollowsMetric
The number of new users who started following your Facebook Page within the reporting period.
New Follows (Unique)Metric
The number of unique new users who started following your Facebook Page within the reporting period.
New UnfollowsMetric
The number of users who unfollowed your Facebook Page within the reporting period.
New Unfollows (Unique)Metric
The number of unique users who unfollowed your Facebook Page within the reporting period.
Offer ClaimsDimension
The number of times offers associated with your Page were claimed.
Offer claimMetric
The total number of times an offer associated with your page was claimed.
Offer claim (Unique)Metric
The number of unique users who claimed an offer associated with your page.
Other ClicksMetric
The total number of clicks on your Page content that are not categorized as link clicks, photo views, or video plays.
Other Clicks (Unique)Metric
The number of unique people who clicked on other elements within your posts (excluding link, photo, or video clicks).
Page IdDimension
The unique identifier of the Facebook Page.
Page NameDimension
The name of the Facebook Page.
Page UnlikesDimension
The total number of unlikes of your Page.
Page Unlikes (Unique)Dimension
The number of unique Accounts Center accounts that unfollowed your Page.
Page Views (Logout)Dimension
The number of times a Page's content or profile was viewed by users who were logged out of Facebook.
Page Views (Total)Metric
The total number of times your Facebook Page was viewed by users, including both logged-in and logged-out individuals.
Page Views by Profile Tab (Logged In) (Unique)Metric
The number of unique users logged in to Facebook who viewed the profile (timeline) tab on your Page.
Page level videos CPM (Crossposted)Metric
The average cost per thousand impressions for ads displayed within videos that were crossposted to your Page.
Page level videos CPM (Owned)Metric
The average cost per thousand impressions for ads displayed within videos that are owned and published directly on your Page.
Page level videos ad impression (Crossposted)Metric
The number of times ads displayed within videos that were crossposted to your Page were shown.
Page level videos ad impression (Owned)Metric
The number of times ads displayed within videos that are owned and published directly on your Page were shown.
Page level videos revenue (Crossposted)Metric
The estimated revenue generated from ads displayed within videos that were crossposted to your Page.
Page level videos revenue (Owned)Metric
The estimated revenue generated from ads displayed within videos that are owned and published directly on your Page.
Photo ViewsMetric
The total number of times photos on your Page or in your posts were viewed.
PictureDimension
The URL for a standard-sized image associated with a post, profile, or other content on a Facebook Page.
Post EngagementsMetric
The total number of actions taken on your posts, including reactions, comments, shares, and clicks.
Question answersDimension
The number of times questions on your Page were answered.
REACTION_ANGERReel Likes (ANGER)Metric
The total number of 'Anger' reactions on a Facebook Reel. This metric is part of the overall reactions insight for Reels.
REACTION_HAHAReel Likes (HAHA)Metric
The total number of 'haha' reactions received on your Reels.
REACTION_LIKEReel Likes (LIKE)Metric
The total number of 'Like' reactions on a Facebook Reel. This metric is part of the overall reactions insight for Reels.
REACTION_LOVEReel Likes (LOVE)Metric
The total number of 'Love' reactions on a Facebook Reel. This metric is part of the overall reactions insight for Reels.
REACTION_SORRYReel Likes (SORRY)Metric
The total number of 'sad' reactions received on your Reels.
REACTION_WOWReel Likes (WOW)Metric
The total number of 'wow' reactions received on your Reels.
RSVPMetric
The total number of responses (Yes, Maybe, No) to events associated with your Facebook Page.
RSVP (Unique)Metric
The number of unique users who responded (Yes, Maybe, No) to events associated with your Facebook Page.
RSVPsDimension
The number of times people RSVP'd to an event associated with your Page.
Reactions TotalDimension
The total sum of all reactions (Like, Love, Haha, Wow, Sad, Angry) on posts from your Page.
Reactions: ANGER (Total)Metric
The total number of 'Angry' reactions on your posts.
Reactions: HAHA (Total)Metric
The total number of 'Haha' reactions on your posts.
Reactions: LIKE (Total)Metric
The total number of 'Like' reactions on your posts.
Reactions: LOVE (Total)Metric
The total number of 'Love' reactions on your posts.
Reactions: SORRY (Total)Metric
The total number of 'Sad' reactions on your posts.
Reactions: WOW (Total)Metric
The total number of 'Wow' reactions on your posts.
Report spam ClicksDimension
The number of times people clicked 'Report an object as a spam' in response to your Page content.
SHAREReel Social Actions (SHARE)Metric
The total number of times a Facebook Reel has been shared. This metric indicates the virality and reach of the Reel.
SharesMetric
The total number of times your Page's posts were shared by users.
Shares (Unique)Metric
The number of unique users who shared your Page's posts.
Social Actions (Unique)Metric
This field represents the unique count of social actions (such as reactions, comments, and shares) performed on a video post or other content associated with your Facebook Page.
TimestampDimension
The specific point in time for which the data is recorded.
Total ActionsMetric
The sum of all actions taken on your Facebook Page or its content, including likes, comments, shares, and other interactions.
Total Video 10s ViewsMetric
The total number of times your Page's videos were played for at least 10 seconds.
Total Video 10s Views (Unique)Metric
The number of unique users who viewed your Page's videos for at least 10 seconds.
Total Video 10s Views Auto PlayedMetric
The total number of times your Page's videos were played for at least 10 seconds due to autoplay, without a user initiating the play.
Total Video 10s Views Clicked To PlayMetric
The total number of times your Page's videos were played for at least 10 seconds because a user explicitly clicked to play them.
Total Video 10s Views OrganicMetric
The total number of times your Page's videos were played for at least 10 seconds through unpaid (organic) distribution.
Total Video 10s Views PaidMetric
The total number of times your Page's videos were played for at least 10 seconds through paid distribution.
Total Video 10s Views Sound OnMetric
The total number of times your Page's videos were played for at least 10 seconds with the sound turned on.
Total Video Ad Break Ad CpmMetric
The average cost per thousand impressions for ads displayed during ad breaks within your videos.
Total Video Ad Break Ad ImpressionsMetric
The total number of times ads displayed during ad breaks within your videos were shown.
Total Video Ad Break EarningsMetric
The estimated earnings generated from ads displayed during ad breaks within your videos.
Total Video Avg Time WatchedMetric
The average amount of time users spent watching your Page's videos.
Total Video Complete ViewsMetric
The total number of times your Page's videos were watched to completion, or nearly their total length.
Total Video Complete Views (Unique)Metric
The number of unique users who watched your Page's videos to completion, or nearly their total length.
Total Video Complete Views Auto PlayedMetric
The total number of times your Page's videos were watched to completion when initiated by autoplay.
Total Video Complete Views Clicked To PlayMetric
The total number of times your Page's videos were watched to completion when initiated by a user click.
Total Video Complete Views OrganicMetric
The total number of times your Page's videos were watched to completion through unpaid (organic) distribution.
Total Video Complete Views Organic (Unique)Metric
The number of unique users who watched your Page's videos to completion through unpaid (organic) distribution.
Total Video Complete Views PaidMetric
The total number of times your Page's videos were watched to completion through paid distribution.
Total Video Complete Views Paid (Unique)Metric
The number of unique users who watched your Page's videos to completion through paid distribution.
Total Video Reactions By Type TotalMetric
The total count of reactions on your videos, broken down by reaction type (e.g., Like, Love, Haha).
Total Video Retention GraphMetric
Data representing the percentage of viewers who continue watching your video at each point in its duration.
Total Video Retention Graph AutoplayedMetric
Data representing viewer retention for videos that were initiated by autoplay.
Total Video Retention Graph Clicked To PlayMetric
Data representing viewer retention for videos that were initiated by a user click.
Total Video Stories By Action TypeMetric
The total number of stories created about your video posts, categorized by the specific action taken.
Total Video View Time By Age Bucket And GenderMetric
The total time users spent watching your videos, broken down by their age range and gender.
Total Video View Time By Distribution TypeMetric
The total time users spent watching your videos, categorized by how the video was distributed (e.g., organic, paid, shared).
Total Video View Time By Region IdMetric
The total time users spent watching your videos, broken down by geographical region.
Total Video View Total TimeMetric
The aggregate amount of time users spent watching your Page's videos.
Total Video View Total Time OrganicMetric
The aggregate amount of time users spent watching your Page's videos through unpaid (organic) distribution.
Total Video View Total Time PaidMetric
The aggregate amount of time users spent watching your Page's videos through paid distribution.
Total Video ViewsMetric
The total number of times your Page's videos were viewed.
Total Video Views AutoplayedMetric
The total number of times your Page's videos were viewed due to autoplay.
Total Video Views By Distribution TypeMetric
The total number of times your Page's videos were viewed, categorized by how the video was distributed.
Total Video Views Clicked To PlayMetric
The total number of times your Page's videos were viewed because a user explicitly clicked to play them.
Total Video Views OrganicMetric
The total number of times your Page's videos were viewed through unpaid (organic) distribution.
Total Video Views PaidMetric
The total number of times your Page's videos were viewed through paid distribution.
Total Video Views Sound OnMetric
The total number of times your Page's videos were viewed with the sound turned on.
TypeDimension
This field identifies the category or nature of the Facebook entity for which the insights data is provided. Examples include a Page, Post, Video, or Reel, helping to classify the type of content or object being analyzed.
Unlike SourceDimension
The source or reason why users unliked a Facebook Page, specifically referring to clicks on the 'Unlike a Page' option in negative feedback.
Users PostsDimension
The number of posts created by people on your Page.
Users Posts (Unique)Dimension
The number of unique people who created posts on your Page.
Video Complete Views 30sMetric
The total number of times your videos were watched for at least 30 seconds, or to completion if shorter.
Video Complete Views 30s (Autoplayed)Metric
The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by autoplay.
Video Complete Views 30s (Click To Play)Metric
The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by a user click.
Video Complete Views 30s (Clicked to Play)Metric
The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) when initiated by a user click.
Video Complete Views 30s (Organic)Metric
The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) through unpaid (organic) distribution.
Video Complete Views 30s (Paid)Metric
The total number of times your videos were watched for at least 30 seconds (or to completion if shorter) through paid distribution.
Video Complete Views 30s (Repeat Views)Metric
The number of times your Page's videos were replayed for at least 30 seconds, or for nearly their total length if shorter.
Video Complete Views 30s (Unique)Metric
The number of unique users who watched your videos for at least 30 seconds, or to completion if shorter.
Video LengthMetric
The duration of the video content.
Video PlaysMetric
The total number of times a video started playing on your Page.
Video Repeat ViewsMetric
The number of times your Page's videos were replayed for at least 3 seconds, or for nearly their total length if shorter.
Video View TimeMetric
The total aggregate time users spent watching your Page's videos.
Video View Time by Age Bucket and GenderMetric
The total time users spent watching your videos, broken down by their age range and gender.
Video View Time by Country IdMetric
The total time users spent watching your videos, broken down by country.
Video View Time by Distribution Type (Page Owned)Metric
The total time, in milliseconds, your Page's videos were viewed when distributed as 'page_owned' content.
Video View Time by Distribution Type (Shared)Metric
The total time, in milliseconds, your Page's videos were viewed when distributed as 'shared' content.
Video View Time by Region IdMetric
The total time users spent watching your videos, broken down by geographical region.
Video ViewsMetric
The total number of times your Page's videos were viewed.
Video Views (Autoplayed)Metric
The total number of times your Page's videos were viewed due to autoplay.
Video Views (Click To Play)Metric
The total number of times your Page's videos were viewed because a user explicitly clicked to play them.
Video Views (Clicked to Play)Metric
The total number of times your Page's videos were viewed because a user explicitly clicked to play them.
Video Views (Organic)Metric
The total number of times your Page's videos were viewed through unpaid (organic) distribution.
Video Views (Paid)Metric
The total number of times your Page's videos were viewed through paid distribution.
Video Views 15sMetric
The total number of times your videos were viewed for at least 15 seconds.
Video Views 60s (excluding videos shorter than 60s)Metric
The total number of times your videos were viewed for at least 60 seconds, excluding videos with a total length shorter than 60 seconds.
Video Views Avg Time WatchedMetric
The average amount of time users spent watching your Page's videos.
Video Views Complete Views (Organic)Metric
The total number of times your Page's videos were watched to completion through unpaid (organic) distribution.
Video Views Complete Views (Organic) (Unique)Metric
The number of unique users who watched your Page's videos to completion through unpaid (organic) distribution.
Video Views Complete Views (Paid)Metric
The total number of times your Page's videos were watched to completion through paid distribution.
Video Views Complete Views (Paid) (Unique)Metric
The number of unique users who watched your Page's videos to completion through paid distribution.
Video Views GraphMetric
A graph showing the number of times your videos played at each interval as a percentage of all views.
Video Views Graph (Autoplayed)Metric
A graph showing the number of times your videos automatically played at each interval as a percentage of all automatic views.
Video Views Graph Clicked To PlayMetric
A graph showing the number of times your videos played at each interval as a percentage of all views, after people clicked play.
Video Views Sound OnMetric
The total number of times your Page's videos were viewed with the sound turned on.
Video Views TimeMetric
The total aggregate time users spent watching your Page's videos.
Video Views Time (Organic)Metric
The total aggregate time users spent watching your Page's videos through unpaid (organic) distribution.
Video Views by Distribution Type (Page Owned)Metric
The number of times your Page's videos played when distributed as 'page_owned' content.
Video Views by Distribution Type (Shared)Metric
The number of times your Page's videos played when distributed as 'shared' content.
Video Views by Paid/Non PaidMetric
The total number of times your videos were viewed, categorized by whether the views originated from paid or unpaid (organic) distribution.
aboutAboutDimension
The 'About' section text of the Facebook Page.
account_idDimension
The unique identifier for the Facebook Page account.
account_nameDimension
The public name of the Facebook Page account.
blue_reels_play_countBlue Reels Play CountMetric
The total count of times a Facebook Reel has been played. This includes initial plays and replays within a session, providing a measure of content viewership.
business_idBusiness IDDimension
The unique identifier for the business associated with the Facebook Page.
business_nameBusiness NameDimension
The name of the business associated with the Facebook Page.
call_to_action_linkCall to Action LinkDimension
The URL linked to the call-to-action button on the Facebook Page or a post.
call_to_action_typeCall to Action TypeDimension
The type of call-to-action button configured for the Facebook Page or a post (e.g., 'Shop Now', 'Learn More').
captionDimension
The descriptive text associated with a photo or video in a post.
clicksMetric
The total number of clicks on your content or Page elements.
commentComments (Unique)Metric
The total number of comments on your Page's posts.
comment_countMetric
The total number of comments on a specific post.
content_categoryContent CategoryDimension
A classification of the content, used for categorizing pages or content, which can be used for analytics and ad optimization.
createdCreatedDimension
The date and time when the content or object was created.
created_dateDimension
The date when the object (e.g., post, comment) was created.
created_timeDimension
The timestamp when the object (e.g., post, comment) was created.
crosspostedPage level videos ad impression (Crossposted)Dimension
Revenue generated from videos that have been crossposted to other Pages.
dateDimension
The specific date for which the data point is recorded.
descriptionDescriptionDimension
A textual description of the content, object, or Page.
engagementMetric
The total number of times people engaged with your posts through reactions, comments, shares, and clicks.
engagement_paidMetric
The number of times people engaged with posts or Page content through paid distribution. This can include reactions, comments, shares, and clicks.
engagement_rateMetric
The total number of times people have engaged with content on your Page, encompassing reactions, comments, and shares. This metric provides the raw data from which an engagement rate can be calculated.
followers_countPage FollowersDimension
The total number of users who follow the Facebook Page.
followsMetric
The total number of followers of your Facebook Page or profile, calculated as the number of follows minus unfollows over the lifetime.
from.idDimension
The unique identifier of the user or Page that created the object (e.g., comment, post).
from.nameDimension
The name of the user or Page that created the object (e.g., comment, post).
from_field.idFrom IdDimension
The unique identifier of the user or Page that created the content.
from_field.nameFrom NameDimension
The name of the user or Page that created the content.
full_pictureFull PictureDimension
The URL to the full-sized image associated with a post or object.
iconIconDimension
The URL to an icon associated with the post type or object.
idIDDimension
The unique identifier for a Facebook object, such as a Page, post, or video.
impressionsMetric
The number of times any content from your Page or about your Page entered a person's screen.
instagram_eligibilityInstagram EligibilityDimension
Indicates whether a Facebook Page or associated content is eligible for certain integrations or functionalities with Instagram, often requiring a linked Instagram Business or Creator Account.
is_crosspost_videoIs Crosspost VideoDimension
A boolean indicating if the video was crossposted from another Page.
is_publishedIs PublishedDimension
A boolean indicating if the content or object is currently published and visible.
lengthLengthDimension
The duration of the video content in seconds.
likeLikes (Unique)Metric
The total number of 'Like' reactions on your Page's posts, photos, or videos.
like_countMetric
The total number of likes on an object.
linkLinkDimension
The URL of the primary link associated with a post or object.
link clicksLink ClicksMetric
The total number of times users clicked on links in your Page's posts or on the Page itself.
messageMessageDimension
The textual content of a post or comment.
message_tagsDimension
A list of tagged users or Pages within the message content of a post or comment.
message_typeDimension
The type of content included in a post, such as a photo, video, or status update.
nameNameDimension
The name of the Page, object, or entity.
object_idObject IdDimension
The unique identifier for a specific object within a post, such as a photo or video.
other clicksOther ClicksMetric
The total number of clicks on your Page content that are not categorized as link clicks, photo views, or video plays.
ownedPage level videos revenue (Owned)Dimension
The estimated revenue generated from ad breaks within videos that are directly owned and published on the Facebook Page. This metric reflects earnings for content where the page is the original creator and publisher.
page_actions_post_reactions_anger_totalActions Post Reactions: ANGER (Total)Metric
The daily total 'anger' reactions on posts of a page.
page_actions_post_reactions_haha_totalActions Post Reactions: HAHA (Total)Metric
The daily total 'haha' reactions on posts of a page.
page_actions_post_reactions_like_totalActions Post Reactions: LIKE (Total)Metric
The daily total 'like' reactions (including 'care' reactions) on posts of a page.
page_actions_post_reactions_love_totalActions Post Reactions: LOVE (Total)Metric
The daily total 'love' reactions on posts of a page.
page_actions_post_reactions_sorry_totalActions Post Reactions: SORRY (Total)Metric
Daily total 'sad' reactions on a Page's posts.
page_actions_post_reactions_totalActions Post Reactions (Total)Metric
The daily total count of all reactions (like, love, wow, haha, sorry, anger) to posts on your Page.
page_actions_post_reactions_wow_totalActions Post Reactions: WOW (Total)Metric
The daily total 'wow' reactions on posts of a page.
page_daily_followsNew FollowsMetric
The daily number of times your Facebook Page or profile was followed.
page_daily_follows_uniqueNew Follows (Unique)Metric
The number of unique Accounts Center accounts that followed your Page in the selected time period.
page_daily_unfollowsNew UnfollowsMetric
The daily number of times your Facebook Page or profile was unfollowed.
page_daily_unfollows_uniqueNew Unfollows (Unique)Metric
The number of unique Accounts Center accounts that unfollowed your Page in the selected time period.
page_fan_adds_by_paid_non_paid_uniqueFan Adds by Paid/Non Paid (Unique)Metric
The unique number of accounts that liked your Page for the first time, broken down by whether the like was attributed to paid or organic content.
page_followsFollowsMetric
The total number of followers for your Facebook Page or profile, calculated as follows minus unfollows over the lifetime.
page_follows_cityFans by CityMetric
Aggregated Facebook location data, sorted by city, about the people who like your Page.
page_follows_countryFans by CountryMetric
The number of people, aggregated per country, that like your Page.
page_idDimension
The unique identifier of the Facebook Page.
page_nameDimension
The public name of the Facebook Page.
page_ownedVideo View Time by Distribution Type (Page Owned)Dimension
Indicates that video view time is attributed to content directly owned and published by the Page.
page_post_engagementsPost EngagementsMetric
The number of times people have engaged with your posts through reactions, comments, shares, and more.
page_total_actionsTotal ActionsMetric
The total number of clicks on your Page's contact information and call-to-action buttons.
page_video_complete_views_30sVideo Complete Views 30sMetric
The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if shorter than 30 seconds. Replays are excluded from a single instance of playing.
page_video_complete_views_30s_click_to_playVideo Complete Views 30s (Click To Play)Metric
The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if shorter, after people clicked play. Replays are excluded from a single instance of playing.
page_video_complete_views_30s_repeat_viewsVideo Complete Views 30s (Repeat Views)Metric
The number of times your Page's videos replayed for at least 30 seconds, or for nearly their total length if shorter than 30 seconds.
page_video_repeat_viewsVideo Repeat ViewsMetric
The number of times your Page's videos were replayed for at least 3 seconds, or nearly their total length if shorter.
page_video_view_timeVideo View TimeMetric
The total time, in milliseconds, people viewed your Page's videos.
page_video_views_by_paid_non_paidVideo Views by Paid/Non PaidMetric
The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if shorter than 3 seconds, broken down by total, paid, and non-paid views.
page_video_views_click_to_playVideo Views (Click To Play)Metric
The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if shorter, after people clicked play. Replays are excluded from a single instance of playing.
page_views_totalPage Views (Total)Metric
The number of times a Page's profile has been viewed by both logged-in and logged-out users.
paid_actions.commentMetric
The number of comments on ads or boosted posts, attributed to paid campaigns.
paid_actions.likeDimension
The number of 'like' reactions on ads or boosted posts, attributed to paid campaigns.
paid_actions.link_clickMetric
The number of clicks on links within ads or boosted posts, attributed to paid campaigns.
paid_actions.post_engagementDimension
The number of times people engaged with an ad or boosted post (e.g., reactions, comments, shares, clicks), attributed to paid campaigns.
paid_actions.post_reactionMetric
The number of reactions (like, love, haha, wow, sad, angry) on ads or boosted posts, attributed to paid campaigns.
paid_actions.video_viewMetric
The number of video views (at least 10 seconds) for ads or boosted video posts, attributed to paid campaigns.
paid_clicksMetric
The total number of clicks on ads or boosted posts, attributed to paid campaigns. This can include various click types like link clicks, post engagements, or page likes.
paid_impressionsDimension
The number of times any content from your Page or about your Page entered a person's screen through paid distribution, such as an ad.
paid_reachMetric
The number of unique Accounts Center accounts that saw your ads at least once.
parent_idParent IdDimension
The unique identifier of the parent object, such as the post ID for a comment, or a parent comment ID for a reply.
periodPeriodDimension
The aggregation period for the insights data (e.g., day, week, lifetime).
permalink_urlPermalinkUrlDimension
The permanent URL for the Facebook post or object.
photo viewPhoto ViewsMetric
The total number of times photos on your Page or in your posts were viewed.
picturePictureDimension
The URL to a thumbnail or preview image associated with a post or object.
platformDimension
The platform where the activity or content originated, such as Facebook.
post_clicksClicksMetric
The total number of clicks on your Page's posts, including links, photos, and video plays.
post_media_viewImpressionsMetric
The total number of times your Page's posts or media content were displayed on someone's screen.
post_media_view:is_from_ads:0Impressions (Organic)Metric
The number of times your Page's posts or media content were displayed on screen through unpaid (organic) distribution.
post_media_view:is_from_ads:1Impressions (Paid)Metric
The number of times your Page's posts or media content were displayed on screen through paid distribution, such as advertisements.
post_media_view:is_from_followers:1Impressions FanMetric
The number of times your content was played or displayed by Accounts Center accounts that followed or liked your Page.
post_reactions_anger_totalReactions: ANGER (Total)Metric
Total 'anger' reactions on a post.
post_reactions_haha_totalReactions: HAHA (Total)Metric
Total 'haha' reactions on a post.
post_reactions_like_totalReactions: LIKE (Total)Metric
Total 'like' reactions on a post. This includes both 'like' and 'care' reactions.
post_reactions_love_totalReactions: LOVE (Total)Metric
Total 'love' reactions on a post.
post_reactions_sorry_totalReactions: SORRY (Total)Metric
Total 'sad' reactions on a post.
post_reactions_wow_totalReactions: WOW (Total)Metric
Total 'wow' reactions on a post.
post_total_media_view_uniqueViews (Unique)Metric
The number of unique individuals who viewed a Facebook post's media content.
post_video_avg_time_watchedVideo Views Avg Time WatchedMetric
The average time, in milliseconds, people viewed your videos.
post_video_complete_views_30s_autoplayedVideo Complete Views 30s (Autoplayed)Metric
The number of times a video automatically played for at least 30 seconds, or nearly its total length if shorter.
post_video_complete_views_30s_clicked_to_playVideo Complete Views 30s (Clicked to Play)Metric
The number of times your videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, after people clicked play.
post_video_complete_views_30s_organicVideo Complete Views 30s (Organic)Metric
The number of times a video played for at least 30 seconds, or nearly its total length if shorter, through organic reach.
post_video_complete_views_30s_paidVideo Complete Views 30s (Paid)Metric
The number of times a promoted video played for at least 30 seconds, or nearly its total length if shorter.
post_video_complete_views_30s_uniqueVideo Complete Views 30s (Unique)Metric
The number of unique people who viewed a video for at least 30 seconds, or nearly its total length if shorter.
post_video_complete_views_organicVideo Views Complete Views (Organic)Metric
The number of times a video played from the beginning to 97% or more of its length, through organic reach.
post_video_complete_views_organic_uniqueVideo Views Complete Views (Organic) (Unique)Metric
The number of unique people who viewed a video from the beginning to 97% or more of its length, through organic reach.
post_video_complete_views_paidVideo Views Complete Views (Paid)Metric
The number of times a promoted video played from the beginning to 97% or more of its length.
post_video_complete_views_paid_uniqueVideo Views Complete Views (Paid) (Unique)Metric
The number of unique people who viewed a promoted video from the beginning to 97% or more of its length.
post_video_lengthVideo LengthMetric
The length of a video post, in milliseconds.
post_video_retention_graphVideo Views GraphMetric
The number of times your videos played at each interval as a percentage of all views.
post_video_retention_graph_autoplayedVideo Views Graph (Autoplayed)Metric
The number of times your videos automatically played at each interval as a percentage of all automatic views.
post_video_retention_graph_clicked_to_playVideo Views Graph Clicked To PlayMetric
The number of times your videos played at each interval as a percentage of all views, after people clicked play.
post_video_social_actions_count_uniqueSocial Actions (Unique)Dimension
The unique count of social actions (reactions, comments, shares) on a video post.
post_video_view_timeReel View Time (Total)Metric
The total time, in milliseconds, your videos played, including views shorter than 3 seconds and replays.
post_video_view_time_by_age_bucket_and_genderVideo View Time by Age Bucket and GenderMetric
The total time, in milliseconds, your videos played for your Top Audiences, broken down by age and gender.
post_video_view_time_by_country_idVideo View Time by Country IdMetric
The total number of minutes your videos played for your Top Locations, broken down by country.
post_video_view_time_by_region_idVideo View Time by Region IdMetric
The total time, in milliseconds, that videos on your Page were viewed, broken down by the top 45 geographical regions (Country - Region).
post_video_view_time_organicVideo Views Time (Organic)Metric
The total time, in milliseconds, your videos played by organic reach.
post_video_viewsVideo ViewsMetric
The number of times a video played for at least 3 seconds, or nearly its total length if shorter than 3 seconds.
post_video_views_15sVideo Views 15sMetric
The number of times your videos played for at least 15 seconds, or for nearly their total length if they're shorter than 15 seconds.
post_video_views_60s_excludes_shorterVideo Views 60s (excluding videos shorter than 60s)Metric
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.
post_video_views_autoplayedVideo Views (Autoplayed)Metric
The number of times a video automatically played for at least 3 seconds, or nearly its total length if shorter.
post_video_views_clicked_to_playVideo Views (Clicked to Play)Metric
The number of times your videos played for at least 3 seconds after people clicked play, or nearly their total length if shorter.
post_video_views_organicVideo Views (Organic)Metric
The number of times a video played for at least 3 seconds, or nearly its total length if shorter, through organic reach.
post_video_views_paidVideo Views (Paid)Metric
The number of times a promoted video played for at least 3 seconds, or nearly its total length if shorter.
post_video_views_sound_onVideo Views Sound OnMetric
The number of times a video played with sound on for at least 3 seconds, or nearly its total length if shorter.
privacyPrivacyDimension
The privacy setting for a specific object (e.g., post, photo, video) that determines the audience who can view it (e.g., EVERYONE, ALL_FRIENDS, SELF).
promotable_idPromotable IdDimension
The unique identifier of a post, video, or other content eligible for promotion or boosting.
promotion_statusPromotion StatusDimension
The current status of a promotion or boosted content, indicating if it is active, paused, or completed.
publishedPublishedDimension
A boolean indicating if the content or object has been published.
reactions_angryMetric
The total number of 'Angry' reactions to a post, comment, or other object on Facebook. This includes the aggregate count of users who expressed an angry sentiment.
reactions_hahaMetric
The total number of 'Haha' reactions to a post, comment, or other object on Facebook, indicating amusement or laughter.
reactions_likeMetric
The total number of 'Like' reactions to a post, comment, or other object on Facebook. This count includes both 'Like' and 'Care' reactions.
reactions_loveMetric
The total number of 'Love' reactions to a post, comment, or other object on Facebook, indicating affection or strong positive sentiment.
reactions_sadMetric
The total number of 'Sad' reactions to a post, comment, or other object on Facebook, indicating empathy or sorrow.
reactions_wowMetric
The total number of 'Wow' reactions to a post, comment, or other object on Facebook, indicating surprise or amazement.
reply_toMetric
For a comment that is a reply, this field indicates the ID of the parent comment.
rsvpRSVPMetric
The number of unique people who RSVP'd to an event.
shareShares (Unique)Metric
The number of times content from your Page has been shared.
sharedVideo View Time by Distribution Type (Shared)Dimension
Indicates that video view time is attributed to content shared by others.
sum_reactionsMetric
The total sum of all reaction types (Like, Love, Haha, Wow, Sad, Angry) on a post or page content.
target.idTarget IdDimension
The unique identifier of the target object, such as the ID of a Page, User, or other entity associated with the data.
target.nameTarget NameDimension
The name of the target object, such as the name of a Page, User, or other entity associated with the data.
target.urlTarget UrlDimension
The URL link to the target object, such as the URL of a Page, User, or other entity associated with the data.
targetingTargetingDimension
Detailed information about the audience targeting applied to a post or ad.
total_video_10s_viewsTotal Video 10s ViewsMetric
The total number of times videos played for at least 10 seconds. This is an aggregated metric.
total_video_ad_break_ad_cpmTotal Video Ad Break Ad CpmMetric
The average amount paid by advertisers for 1,000 impressions of their ads in your videos.
total_video_ad_break_ad_impressionsTotal Video Ad Break Ad ImpressionsMetric
The total number of times an ad was shown during ad breaks in your videos.
total_video_ad_break_earningsTotal Video Ad Break EarningsMetric
An estimate of the amount earned from ad breaks in your videos, based on impressions and CPM of ads shown.
total_video_avg_time_watchedTotal Video Avg Time WatchedMetric
The average time, in milliseconds, people viewed your videos.
total_video_complete_viewsTotal Video Complete ViewsMetric
The total number of times videos played from the beginning to 97% or more of their length.
total_video_complete_views_auto_playedTotal Video Complete Views Auto PlayedMetric
The total number of times videos automatically played for at least 30 seconds (or nearly their total length if shorter).
total_video_complete_views_clicked_to_playTotal Video Complete Views Clicked To PlayMetric
The total number of times videos played for at least 30 seconds (or nearly their total length if shorter) after people clicked play.
total_video_complete_views_organicTotal Video Complete Views OrganicMetric
The total number of times videos played from the beginning to 97% or more of its length, by organic reach.
total_video_complete_views_organic_uniqueTotal Video Complete Views Organic (Unique)Metric
The total number of unique people who viewed videos from the beginning to 97% or more of its length, by organic reach.
total_video_complete_views_paidTotal Video Complete Views PaidMetric
The total number of times promoted videos played from the beginning to 97% or more of its length.
total_video_complete_views_paid_uniqueTotal Video Complete Views Paid (Unique)Metric
The total number of unique people who viewed promoted videos from the beginning to 97% or more of its length.
total_video_complete_views_uniqueTotal Video Complete Views (Unique)Metric
The total number of unique people who viewed videos for at least 30 seconds (or nearly their total length if shorter).
total_video_reactions_by_type_totalTotal Video Reactions By Type TotalDimension
The total number of reactions by type on a video post.
total_video_retention_graphTotal Video Retention GraphDimension
Data representing the percentage of viewers who continue watching your video at each point in its duration. Videos are divided into 40 equal intervals.
total_video_retention_graph_autoplayedTotal Video Retention Graph AutoplayedDimension
Data representing viewer retention for videos that were initiated by autoplay, showing the percentage of viewers who continue watching at each interval.
total_video_retention_graph_clicked_to_playTotal Video Retention Graph Clicked To PlayDimension
The number of times videos played at each interval (as a percentage of all views) after people clicked play, divided into 40 equal intervals.
total_video_stories_by_action_typeTotal Video Stories By Action TypeDimension
The number of stories created about a video post, broken down by action type (e.g., shares, mentions).
total_video_view_time_by_age_bucket_and_genderTotal Video View Time By Age Bucket And GenderDimension
The total time, in milliseconds, that videos were played for your top audiences, broken down by age and gender.
total_video_view_time_by_distribution_typeTotal Video View Time By Distribution TypeDimension
The total time users spent watching your videos, categorized by how the video was distributed (e.g., page-owned and shared).
total_video_view_time_by_region_idTotal Video View Time By Region IdDimension
The total time, in milliseconds, that videos were played for your top 45 locations, broken down by region and country.
total_video_view_total_timeTotal Video View Total TimeMetric
The total time, in milliseconds, videos were viewed.
total_video_view_total_time_organicTotal Video View Total Time OrganicMetric
The total time, in milliseconds, that videos were played through organic reach.
total_video_view_total_time_paidTotal Video View Total Time PaidMetric
The total time, in milliseconds, that promoted videos were played.
total_video_viewsTotal Video ViewsMetric
The total number of times videos played for at least 3 seconds, or nearly their total length if shorter.
total_video_views_autoplayedTotal Video Views AutoplayedMetric
The total number of times your Page's videos automatically played for at least 3 seconds.
total_video_views_by_distribution_typeTotal Video Views By Distribution TypeDimension
The number of times your videos played, broken down by distribution type (page_owned and shared).
total_video_views_clicked_to_playTotal Video Views Clicked To PlayMetric
The total number of times your Page's videos played for at least 3 seconds after people clicked play.
total_video_views_organicTotal Video Views OrganicMetric
The total number of times videos played for at least 3 seconds through organic reach.
total_video_views_paidTotal Video Views PaidMetric
The total number of times promoted videos played for at least 3 seconds.
total_video_views_sound_onTotal Video Views Sound OnMetric
The number of times videos played with sound on for at least 3 seconds (or nearly their total length if shorter).
typeTypeDimension
The type of the Facebook object or content (e.g., 'photo', 'video', 'link', 'status').
updated_timeUpdated timeDimension
The date and time when the content or object was last updated.
video playVideo PlaysMetric
The number of times a video was played.
watchtimeDimension
The total time, in milliseconds, that your videos were viewed.