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.
Answers Metric
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 Type Dimension
The category used to segment insights data, such as age, gender, or country.
Breakdown Value Dimension
The specific value within a breakdown category (e.g., '18-24' for age, 'Male' for gender).
COMMENT Reel 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-Ins Dimension
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.
City Dimension
Demographic breakdown of users or fans by city.
Clicks Metric
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.
Comments Metric
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.
Consumptions Metric
The total number of times people engaged with your content by clicking on it, viewing photos, playing videos, or interacting with links.
Country Dimension
Demographic breakdown of users or fans by country.
Date Dimension
The date for which the insights data is reported.
Engaged Users Metric
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 Adds Metric
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 Removes Metric
The number of users who unliked your Facebook Page within the reporting period.
Fans Metric
The total number of people who have liked your Page.
Fans by City Metric
The distribution of your Facebook Page followers by city.
Fans by Country Metric
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).
Follows Metric
The total number of users who follow your Facebook Page.
ID Metric
A unique identifier for the Facebook object (e.g., page, post, video, comment) from which the data is collected.
Impressions Metric
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 Fan Metric
The total number of times any of your Page's fans saw your posts on Facebook.
Like Source Dimension
The source from which a Page like originated, such as Ads, News Feed, Page Suggestions, or Search.
Likes Metric
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 Clicks Metric
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.
Links Metric
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.
Mentions Dimension
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.
Message Dimension
The textual content of a post or comment. This field captures the actual message body associated with user-generated content or page posts.
Name Dimension
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 Feedback Metric
The number of negative feedback actions, such as hiding posts or reporting spam.
New Follows Metric
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 Unfollows Metric
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 Claims Dimension
The number of times offers associated with your Page were claimed.
Offer claim Metric
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 Clicks Metric
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 Id Dimension
The unique identifier of the Facebook Page.
Page Name Dimension
The name of the Facebook Page.
Page Unlikes Dimension
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 Views Metric
The total number of times photos on your Page or in your posts were viewed.
Post Engagements Metric
The total number of actions taken on your posts, including reactions, comments, shares, and clicks.
Question answers Dimension
The number of times questions on your Page were answered.
REACTION_ANGER Reel 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_HAHA Reel Likes (HAHA) Metric
The total number of 'haha' reactions received on your Reels.
REACTION_LIKE Reel 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_LOVE Reel 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_SORRY Reel Likes (SORRY) Metric
The total number of 'sad' reactions received on your Reels.
REACTION_WOW Reel Likes (WOW) Metric
The total number of 'wow' reactions received on your Reels.
RSVP Metric
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.
RSVPs Dimension
The number of times people RSVP'd to an event associated with your Page.
Reactions Total Dimension
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 Clicks Dimension
The number of times people clicked 'Report an object as a spam' in response to your Page content.
SHARE Reel 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.
Shares Metric
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.
Timestamp Dimension
The specific point in time for which the data is recorded.
Total Actions Metric
The sum of all actions taken on your Facebook Page or its content, including likes, comments, shares, and other interactions.
Total Video 10s Views Metric
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 Played Metric
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 Play Metric
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 Organic Metric
The total number of times your Page's videos were played for at least 10 seconds through unpaid (organic) distribution.
Total Video 10s Views Paid Metric
The total number of times your Page's videos were played for at least 10 seconds through paid distribution.
Total Video 10s Views Sound On Metric
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 Cpm Metric
The average cost per thousand impressions for ads displayed during ad breaks within your videos.
Total Video Ad Break Ad Impressions Metric
The total number of times ads displayed during ad breaks within your videos were shown.
Total Video Ad Break Earnings Metric
The estimated earnings generated from ads displayed during ad breaks within your videos.
Total Video Avg Time Watched Metric
The average amount of time users spent watching your Page's videos.
Total Video Complete Views Metric
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 Played Metric
The total number of times your Page's videos were watched to completion when initiated by autoplay.
Total Video Complete Views Clicked To Play Metric
The total number of times your Page's videos were watched to completion when initiated by a user click.
Total Video Complete Views Organic Metric
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 Paid Metric
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 Total Metric
The total count of reactions on your videos, broken down by reaction type (e.g., Like, Love, Haha).
Total Video Retention Graph Metric
Data representing the percentage of viewers who continue watching your video at each point in its duration.
Total Video Retention Graph Autoplayed Metric
Data representing viewer retention for videos that were initiated by autoplay.
Total Video Retention Graph Clicked To Play Metric
Data representing viewer retention for videos that were initiated by a user click.
Total Video Stories By Action Type Metric
The total number of stories created about your video posts, categorized by the specific action taken.
Total Video View Time By Age Bucket And Gender Metric
The total time users spent watching your videos, broken down by their age range and gender.
Total Video View Time By Distribution Type Metric
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 Id Metric
The total time users spent watching your videos, broken down by geographical region.
Total Video View Total Time Metric
The aggregate amount of time users spent watching your Page's videos.
Total Video View Total Time Organic Metric
The aggregate amount of time users spent watching your Page's videos through unpaid (organic) distribution.
Total Video View Total Time Paid Metric
The aggregate amount of time users spent watching your Page's videos through paid distribution.
Total Video Views Metric
The total number of times your Page's videos were viewed.
Total Video Views Autoplayed Metric
The total number of times your Page's videos were viewed due to autoplay.
Total Video Views By Distribution Type Metric
The total number of times your Page's videos were viewed, categorized by how the video was distributed.
Total 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.
Total Video Views Organic Metric
The total number of times your Page's videos were viewed through unpaid (organic) distribution.
Total Video Views Paid Metric
The total number of times your Page's videos were viewed through paid distribution.
Total Video Views Sound On Metric
The total number of times your Page's videos were viewed with the sound turned on.
Type Dimension
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 Source Dimension
The source or reason why users unliked a Facebook Page, specifically referring to clicks on the 'Unlike a Page' option in negative feedback.
Users Posts Dimension
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 30s Metric
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 Length Metric
The duration of the video content.
Video Plays Metric
The total number of times a video started playing on your Page.
Video Repeat Views Metric
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 Time Metric
The total aggregate time users spent watching your Page's videos.
Video View Time by Age Bucket and Gender Metric
The total time users spent watching your videos, broken down by their age range and gender.
Video View Time by Country Id Metric
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 Id Metric
The total time users spent watching your videos, broken down by geographical region.
Video Views Metric
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 15s Metric
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 Watched Metric
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 Graph Metric
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 Play Metric
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 On Metric
The total number of times your Page's videos were viewed with the sound turned on.
Video Views Time Metric
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 Paid Metric
The total number of times your videos were viewed, categorized by whether the views originated from paid or unpaid (organic) distribution.
about About Dimension
The 'About' section text of the Facebook Page.
account_id Dimension
The unique identifier for the Facebook Page account.
account_name Dimension
The public name of the Facebook Page account.
blue_reels_play_count Blue Reels Play Count Metric
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_id Business ID Dimension
The unique identifier for the business associated with the Facebook Page.
business_name Business Name Dimension
The name of the business associated with the Facebook Page.
call_to_action_link Call to Action Link Dimension
The URL linked to the call-to-action button on the Facebook Page or a post.
call_to_action_type Call to Action Type Dimension
The type of call-to-action button configured for the Facebook Page or a post (e.g., 'Shop Now', 'Learn More').
caption Dimension
The descriptive text associated with a photo or video in a post.
clicks Metric
The total number of clicks on your content or Page elements.
comment Comments (Unique) Metric
The total number of comments on your Page's posts.
comment_count Metric
The total number of comments on a specific post.
content_category Content Category Dimension
A classification of the content, used for categorizing pages or content, which can be used for analytics and ad optimization.
created Created Dimension
The date and time when the content or object was created.
created_date Dimension
The date when the object (e.g., post, comment) was created.
created_time Dimension
The timestamp when the object (e.g., post, comment) was created.
crossposted Page level videos ad impression (Crossposted) Dimension
Revenue generated from videos that have been crossposted to other Pages.
date Dimension
The specific date for which the data point is recorded.
description Description Dimension
A textual description of the content, object, or Page.
engagement Metric
The total number of times people engaged with your posts through reactions, comments, shares, and clicks.
engagement_paid Metric
The number of times people engaged with posts or Page content through paid distribution. This can include reactions, comments, shares, and clicks.
engagement_rate Metric
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_count Page Followers Dimension
The total number of users who follow the Facebook Page.
follows Metric
The total number of followers of your Facebook Page or profile, calculated as the number of follows minus unfollows over the lifetime.
from.id Metric
The unique identifier of the user or Page that created the object (e.g., comment, post).
from.name Dimension
The name of the user or Page that created the object (e.g., comment, post).
from_field.id From Id Dimension
The unique identifier of the user or Page that created the content.
from_field.name From Name Dimension
The name of the user or Page that created the content.
full_picture Full Picture Dimension
The URL to the full-sized image associated with a post or object.
icon Icon Dimension
The URL to an icon associated with the post type or object.
id ID Dimension
The unique identifier for a Facebook object, such as a Page, post, or video.
impressions Metric
The number of times any content from your Page or about your Page entered a person's screen.
instagram_eligibility Instagram Eligibility Dimension
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_video Is Crosspost Video Dimension
A boolean indicating if the video was crossposted from another Page.
is_published Is Published Dimension
A boolean indicating if the content or object is currently published and visible.
length Length Dimension
The duration of the video content in seconds.
like Likes (Unique) Metric
The total number of 'Like' reactions on your Page's posts, photos, or videos.
like_count Metric
The total number of likes on an object.
link Link Dimension
The URL of the primary link associated with a post or object.
link clicks Link Clicks Metric
The total number of times users clicked on links in your Page's posts or on the Page itself.
message Message Dimension
The textual content of a post or comment.
message_tags Metric
A list of tagged users or Pages within the message content of a post or comment.
message_type Dimension
The type of content included in a post, such as a photo, video, or status update.
name Name Dimension
The name of the Page, object, or entity.
object_id Object Id Dimension
The unique identifier for a specific object within a post, such as a photo or video.
other clicks Other Clicks Metric
The total number of clicks on your Page content that are not categorized as link clicks, photo views, or video plays.
owned Page 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_total Actions Post Reactions: ANGER (Total) Metric
The daily total 'anger' reactions on posts of a page.
page_actions_post_reactions_haha_total Actions Post Reactions: HAHA (Total) Metric
The daily total 'haha' reactions on posts of a page.
page_actions_post_reactions_like_total Actions Post Reactions: LIKE (Total) Metric
The daily total 'like' reactions (including 'care' reactions) on posts of a page.
page_actions_post_reactions_love_total Actions Post Reactions: LOVE (Total) Metric
The daily total 'love' reactions on posts of a page.
page_actions_post_reactions_sorry_total Actions Post Reactions: SORRY (Total) Metric
Daily total 'sad' reactions on a Page's posts.
page_actions_post_reactions_total Actions 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_total Actions Post Reactions: WOW (Total) Metric
The daily total 'wow' reactions on posts of a page.
page_daily_follows New Follows Metric
The daily number of times your Facebook Page or profile was followed.
page_daily_follows_unique New Follows (Unique) Metric
The number of unique Accounts Center accounts that followed your Page in the selected time period.
page_daily_unfollows New Unfollows Metric
The daily number of times your Facebook Page or profile was unfollowed.
page_daily_unfollows_unique New 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_unique Fan 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_follows Follows Metric
The total number of followers for your Facebook Page or profile, calculated as follows minus unfollows over the lifetime.
page_follows_city Fans by City Metric
Aggregated Facebook location data, sorted by city, about the people who like your Page.
page_follows_country Fans by Country Metric
The number of people, aggregated per country, that like your Page.
page_id Dimension
The unique identifier of the Facebook Page.
page_name Dimension
The public name of the Facebook Page.
page_owned Video View Time by Distribution Type (Page Owned) Metric
Indicates that video view time is attributed to content directly owned and published by the Page.
page_post_engagements Post Engagements Metric
The number of times people have engaged with your posts through reactions, comments, shares, and more.
page_total_actions Total Actions Metric
The total number of clicks on your Page's contact information and call-to-action buttons.
page_video_complete_views_30s Video Complete Views 30s Metric
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_play Video 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_views Video 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_views Video Repeat Views Metric
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_time Video View Time Metric
The total time, in milliseconds, people viewed your Page's videos.
page_video_views_by_paid_non_paid Video Views by Paid/Non Paid Metric
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_play Video 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_total Page Views (Total) Metric
The number of times a Page's profile has been viewed by both logged-in and logged-out users.
paid_actions.comment Metric
The number of comments on ads or boosted posts, attributed to paid campaigns.
paid_actions.like Dimension
The number of 'like' reactions on ads or boosted posts, attributed to paid campaigns.
paid_actions.link_click Metric
The number of clicks on links within ads or boosted posts, attributed to paid campaigns.
paid_actions.post_engagement Dimension
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_reaction Metric
The number of reactions (like, love, haha, wow, sad, angry) on ads or boosted posts, attributed to paid campaigns.
paid_actions.video_view Metric
The number of video views (at least 10 seconds) for ads or boosted video posts, attributed to paid campaigns.
paid_clicks Metric
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_impressions Dimension
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_reach Metric
The number of unique Accounts Center accounts that saw your ads at least once.
parent_id Parent Id Dimension
The unique identifier of the parent object, such as the post ID for a comment, or a parent comment ID for a reply.
period Period Dimension
The aggregation period for the insights data (e.g., day, week, lifetime).
permalink_url PermalinkUrl Dimension
The permanent URL for the Facebook post or object.
photo view Photo Views Metric
The total number of times photos on your Page or in your posts were viewed.
picture Picture Dimension
The URL to a thumbnail or preview image associated with a post or object.
platform Dimension
The platform where the activity or content originated, such as Facebook.
post_clicks Clicks Metric
The total number of clicks on your Page's posts, including links, photos, and video plays.
post_media_view Impressions Metric
The total number of times your Page's posts or media content were displayed on someone's screen.
post_media_view:is_from_ads:0 Impressions (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:1 Impressions (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:1 Impressions Fan Metric
The number of times your content was played or displayed by Accounts Center accounts that followed or liked your Page.
post_reactions_anger_total Reactions: ANGER (Total) Metric
Total 'anger' reactions on a post.
post_reactions_haha_total Reactions: HAHA (Total) Metric
Total 'haha' reactions on a post.
post_reactions_like_total Reactions: LIKE (Total) Metric
Total 'like' reactions on a post. This includes both 'like' and 'care' reactions.
post_reactions_love_total Reactions: LOVE (Total) Metric
Total 'love' reactions on a post.
post_reactions_sorry_total Reactions: SORRY (Total) Metric
Total 'sad' reactions on a post.
post_reactions_wow_total Reactions: WOW (Total) Metric
Total 'wow' reactions on a post.
post_total_media_view_unique Views (Unique) Metric
The number of unique individuals who viewed a Facebook post's media content.
post_video_avg_time_watched Video Views Avg Time Watched Metric
The average time, in milliseconds, people viewed your videos.
post_video_complete_views_30s_autoplayed Video 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_play Video 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_organic Video 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_paid Video 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_unique Video 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_organic Video 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_unique Video 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_paid Video 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_unique Video 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_length Video Length Metric
The length of a video post, in milliseconds.
post_video_retention_graph Video Views Graph Metric
The number of times your videos played at each interval as a percentage of all views.
post_video_retention_graph_autoplayed Video 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_play Video Views Graph Clicked To Play Dimension
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_unique Social Actions (Unique) Dimension
The unique count of social actions (reactions, comments, shares) on a video post.
post_video_view_time Reel 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_gender Video View Time by Age Bucket and Gender Metric
The total time, in milliseconds, your videos played for your Top Audiences, broken down by age and gender.
post_video_view_time_by_country_id Video View Time by Country Id Metric
The total number of minutes your videos played for your Top Locations, broken down by country.
post_video_view_time_by_region_id Video View Time by Region Id Metric
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_organic Video Views Time (Organic) Metric
The total time, in milliseconds, your videos played by organic reach.
post_video_views Video Views Metric
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_15s Video Views 15s Metric
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_shorter Video 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_autoplayed Video 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_play Video 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_organic Video 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_paid Video 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_on Video Views Sound On Metric
The number of times a video played with sound on for at least 3 seconds, or nearly its total length if shorter.
privacy Privacy Dimension
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_id Promotable Id Dimension
The unique identifier of a post, video, or other content eligible for promotion or boosting.
promotion_status Promotion Status Dimension
The current status of a promotion or boosted content, indicating if it is active, paused, or completed.
published Published Dimension
A boolean indicating if the content or object has been published.
reply_to Metric
For a comment that is a reply, this field indicates the ID of the parent comment.
rsvp RSVP Metric
The number of unique people who RSVP'd to an event.
share Shares (Unique) Metric
The number of times content from your Page has been shared.
shared Video View Time by Distribution Type (Shared) Metric
Indicates that video view time is attributed to content shared by others.
sum_reactions Metric
The total sum of all reaction types (Like, Love, Haha, Wow, Sad, Angry) on a post or page content.
target.id Target Id Dimension
The unique identifier of the target object, such as the ID of a Page, User, or other entity associated with the data.
target.name Target Name Dimension
The name of the target object, such as the name of a Page, User, or other entity associated with the data.
target.url Target Url Dimension
The URL link to the target object, such as the URL of a Page, User, or other entity associated with the data.
targeting Targeting Dimension
Detailed information about the audience targeting applied to a post or ad.
total_video_10s_views Total Video 10s Views Metric
The total number of times videos played for at least 10 seconds. This is an aggregated metric.
total_video_ad_break_ad_cpm Total Video Ad Break Ad Cpm Metric
The average amount paid by advertisers for 1,000 impressions of their ads in your videos.
total_video_ad_break_ad_impressions Total Video Ad Break Ad Impressions Metric
The total number of times an ad was shown during ad breaks in your videos.
total_video_ad_break_earnings Total Video Ad Break Earnings Metric
An estimate of the amount earned from ad breaks in your videos, based on impressions and CPM of ads shown.
total_video_avg_time_watched Total Video Avg Time Watched Metric
The average time, in milliseconds, people viewed your videos.
total_video_complete_views Total Video Complete Views Metric
The total number of times videos played from the beginning to 97% or more of their length.
total_video_complete_views_auto_played Total Video Complete Views Auto Played Metric
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_play Total Video Complete Views Clicked To Play Metric
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_organic Total Video Complete Views Organic Metric
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_unique Total 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_paid Total Video Complete Views Paid Metric
The total number of times promoted videos played from the beginning to 97% or more of its length.
total_video_complete_views_paid_unique Total 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_unique Total 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_total Total Video Reactions By Type Total Metric
The total number of reactions by type on a video post.
total_video_retention_graph Total Video Retention Graph Metric
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_autoplayed Total Video Retention Graph Autoplayed Dimension
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_play Total Video Retention Graph Clicked To Play Dimension
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_type Total Video Stories By Action Type Metric
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_gender Total Video View Time By Age Bucket And Gender Dimension
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_type Total Video View Time By Distribution Type Dimension
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_id Total Video View Time By Region Id Dimension
The total time, in milliseconds, that videos were played for your top 45 locations, broken down by region and country.
total_video_view_total_time Total Video View Total Time Metric
The total time, in milliseconds, videos were viewed.
total_video_view_total_time_organic Total Video View Total Time Organic Metric
The total time, in milliseconds, that videos were played through organic reach.
total_video_view_total_time_paid Total Video View Total Time Paid Metric
The total time, in milliseconds, that promoted videos were played.
total_video_views Total Video Views Metric
The total number of times videos played for at least 3 seconds, or nearly their total length if shorter.
total_video_views_autoplayed Total Video Views Autoplayed Metric
The total number of times your Page's videos automatically played for at least 3 seconds.
total_video_views_by_distribution_type Total Video Views By Distribution Type Dimension
The number of times your videos played, broken down by distribution type (page_owned and shared).
total_video_views_clicked_to_play Total Video Views Clicked To Play Metric
The total number of times your Page's videos played for at least 3 seconds after people clicked play.
total_video_views_organic Total Video Views Organic Metric
The total number of times videos played for at least 3 seconds through organic reach.
total_video_views_paid Total Video Views Paid Metric
The total number of times promoted videos played for at least 3 seconds.
total_video_views_sound_on Total Video Views Sound On Metric
The number of times videos played with sound on for at least 3 seconds (or nearly their total length if shorter).
type Type Dimension
The type of the Facebook object or content (e.g., 'photo', 'video', 'link', 'status').
updated_time Updated time Dimension
The date and time when the content or object was last updated.
video play Video Plays Metric
The number of times a video was played.
watchtime Dimension
The total time, in milliseconds, that your videos were viewed.