Facebook Insights fields

  • Updated on Sep 11, 2025
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your Facebook Insights data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

186 metrics90 dimensions

CONTENT IMPRESSIONS

page_impressions
Field label Total impressions
Description The total number of impressions seen of any content associated with your Page
Field type metric
Data type int.number.value
page_impressions_paid
Field label Paid impressions
Description The number of impressions of a Sponsored Story or Ad pointing to your Page
Field type metric
Data type int.number.value
page_impressions_viral
Field label Viral impressions
Description The number of impressions of a story published by a friend about your Page. These stories include liking your Page, posting to your Page's Timeline, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
Field type metric
Data type int.number.value
page_impressions_nonviral
Field label Non-viral impressions
Description The number of times your Page's posts entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Field type metric
Data type int.number.value
page_posts_impressions
Field label Total impressions of posts
Description The number of times your Page's posts entered a person's screen. Posts include statuses, photos, links, videos and more
Field type metric
Data type int.number.value
page_posts_impressions_paid
Field label Paid impressions of posts
Description The number of times your Page's posts entered a person's screen through paid distribution such as an ad
Field type metric
Data type int.number.value
page_posts_impressions_viral
Field label Viral impressions of posts
Description The number of times your Page's posts entered a person's screen with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Field type metric
Data type int.number.value
page_posts_impressions_nonviral
Field label Non-viral impressions of posts
Description The number of times your Page's posts entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Field type metric
Data type int.number.value
post_impressions_organic
Field label Post organic impressions
Description The number of times your post was on screen through organic distribution
Field type metric
Data type int.number.value

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEPRECATED

gender
Field label Gender
Field type dimension
Data type string.person.gender
🚫 Deprecated Deprecated on 2024-09-16
review_recommendation_type
Field label Recommendation type
Description Whether or not this recommendation was "positive" or "negative".
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2025-03-19
genderage
Field label Gender & age
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-09-16
age
Field label Age
Field type dimension
Data type string.person.age
🚫 Deprecated Deprecated on 2024-09-16
reviewer_id
Field label Reviewer ID
Description The author ID of a recommendation/review.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2025-03-19
review_created_date
Field label Review creation date
Description Date then review was created.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2025-03-19
has_review_rating
Field label Has rating
Description Was a rating included in the recommendation/review (1-5 stars).
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2025-03-19
reviewer_name
Field label Reviewer
Description The author name of a recommendation/review.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2025-03-19
review_text
Field label Review text
Description Review text included in the review.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2025-03-19
has_review
Field label Has review
Description Was there text in the rating in the recommendation/review.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2025-03-19
consumption_type
Field label Content click type
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-09-16
feedback_type
Field label Action type
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-09-16
like_source
Field label Page like source
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-03-14
story_type
Field label Story type
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-09-16
tab
Field label Page tab
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2024-03-14
post_video_watch_10s_rate_autoplayed
Field label Auto-played watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
page_places_checkin_mobile
Field label Check-ins using mobile
Description The number of times people checked into a place using mobile phones.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
post_video_views_10s_paid
Field label Paid 10s video views
Description The number of times your Page's promoted videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
post_video_watch_10s_rate
Field label Watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
EngagedUserPerc
Field label Engagement rate (% of reached people who clicked)
Description Percent of reached people who engaged with your page or post.
Field type metric
Data type float.number.percentage
🚫 Deprecated Deprecated on 2024-03-14
Aggregation Non-aggregatable metric
page_views_unique
Field label People visiting your page
Description Page Views from users logged in to Facebook.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
Aggregation Non-aggregatable metric
page_engaged_users
Field label Engaged users
Description The number of people who engaged with your Page. Engagement includes any click.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_posts_impressions_organic_unique
Field label Organic reach of posts
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
OrganicReachPerc
Field label % of reach from organic
Description The number of people who had any content from your Page or about your Page enter their screen through unpaid distribution.
Field type metric
Data type float.number.percentage
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
page_impressions_organic_unique
Field label Organic reach
Description The number of people who saw any unpaid content from your Page or about your Page in News Feed or on visits to your Page.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
page_positive_feedback
Field label Positive actions
Description The number of times people took a positive action.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_positive_feedback_unique
Field label People taking positive actions
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
Aggregation Non-aggregatable metric
page_likes
Field label Likes
Description The number of times people took the positive feedback action to like a story or post on the page.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
post_video_views_10s_click_to_play
Field label Clicked to play 10s video views
Description The number of times your Page's videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds, after people clicked play.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
page_shares
Field label Shares
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
post_video_watch_10s_rate_organic
Field label Organic watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
page_comments
Field label Comments
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_places_checkin_total
Field label Check-ins
Description The number of times people checked into a place.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
page_negative_feedback
Field label Negative actions
Description The number of times people took a negative action (e.g., un-liked or hid a post).
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
review_rating
Field label Rating
Description Rating (1-5 stars).
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2025-03-19
page_negative_feedback_unique
Field label People taking negative actions
Description The number of people who took a negative action (e.g., un-liked or hid a post).
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
NegativeActionRate
Field label Negative action rate
Description Rate of negative actions (eg. unlike, post hide) relative to reach.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-09-16
page_consumptions
Field label Content clicks
Description The number of times people clicked on any of your content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_all_clicks
Field label All clicks
Description Total number of clicks on all content types in the page such as links, videos, images, etc.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
page_link_clicks
Field label Link clicks
Description The number of clicks, taps, or swipes on links within your content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
page_fans_online_per_day
Field label Page likers (fans) online per day
Description The number of your fans who saw any posts on Facebook on a given day.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
page_other_clicks
Field label Other clicks
Description The number of non-link clicks, taps, or swipes within your content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
post_video_views_10s_autoplayed
Field label Auto-played 10s video views
Description The number of times your Page's videos automatically played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
page_photo_view_clicks
Field label Photo view clicks
Description The number of clicks, taps, or swipes on your photo content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
post_video_views_10s_sound_on
Field label 10s video views with sound on
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
page_video_play_clicks
Field label Video play clicks
Description The number of clicks, taps, or swipes on your video content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
post_video_watch_10s_rate_unique
Field label Unique watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
page_consumptions_unique
Field label People clicking your content
Description The number of people who clicked on any of your content.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
post_video_watch_10s_rate_paid
Field label Paid watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
page_stories
Field label Content stories
Description The number of stories created about your Page (Stories).
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
post_video_watch_10s_rate_click_to_play
Field label Clicked to play watch 10s rate
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2024-04-18
post_likes_on_shares
Field label Likes on post shares
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_places_checkin_total_unique
Field label People checking in
Description The number of people who checked into a place.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
post_comments_on_shares
Field label Comments on post shares
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
page_places_checkin_mobile_unique
Field label People checking in using mobile
Description The number of people who checked into a place using mobile phones.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
Aggregation Non-aggregatable metric
post_shares_on_shares
Field label Shares on post shares
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-03-14
post_link_clicks_unique
Field label Post unique link clicks
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
post_other_clicks_unique
Field label Post unique other clicks
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
post_photo_views_unique
Field label Post unique photo views
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
post_engaged_users
Field label Post engaged users
Description The number of people who clicked anywhere in your posts.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
PostEngagedUserPerc
Field label Post engagement rate
Description Percent of reached people who engaged with your post. Calculated with Post engaged users/Post reach.
Field type metric
Data type float.number.percentage
🚫 Deprecated Deprecated on 2024-09-16
Aggregation Non-aggregatable metric
page_views
Field label Total page views
Description Number of times any tabs (e.g. Timeline, photo) of page's profile has been visited.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
page_impressions_organic
Field label Organic impressions
Description The number of times people saw any unpaid content from your Page or about your Page in News Feed or on visits to your Page.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
page_posts_impressions_organic
Field label Organic impressions of posts
Description The number of times your Page's posts entered a person's screen through unpaid distribution.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-09-16
post_video_views_10s
Field label Total 10s video views
Description The number of times your video was watched for an aggregate of at least 10 seconds, or for nearly its total length, whichever happened first. Returns 0 for reshared videos.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
post_video_views_10s_unique
Field label Unique 10s video views
Description The number of people who viewed your Page's videos for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18
post_video_views_10s_organic
Field label Organic 10s video views
Description The number of times your Page's videos played for at least 10 seconds, or for nearly their total length if they're shorter than 10 seconds, by organic reach.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2024-04-18

ENGAGEMENT & SHARING

page_post_engagements
Field label Page post engagements
Description The number of times people have engaged with your posts through likes, comments and shares and more
Field type metric
Data type int.number.value

FEED TARGETING

feed_targeting_age_min
Field label Feed targeting age min
Description Minimum age. Default is 0
Field type dimension
Data type string.text.value
feed_targeting_age_max
Field label Feed targeting age max
Description Maximum age
Field type dimension
Data type string.text.value
feed_targeting_cities
Field label Feed targeting cities
Description Targeting cities
Field type dimension
Data type string.text.value
feed_targeting_college_years
Field label Feed targeting collage years
Description Targeting graduation year from college
Field type dimension
Data type string.text.value
feed_targeting_countries
Field label Feed targeting countries
Description Targeting countries
Field type dimension
Data type string.text.value
feed_targeting_education_statuses
Field label Feed targeting education statuses
Description Targeting based on education levels
Field type dimension
Data type string.text.value
feed_targeting_genders
Field label Feed targeting genders
Description Targeting genders
Field type dimension
Data type string.text.value
feed_targeting_interests
Field label Feed targeting interests
Description Targeting fans interests
Field type dimension
Data type string.text.value
feed_targeting_locales
Field label Feed targeting locales
Description Targeted locales
Field type dimension
Data type string.text.value
feed_targeting_regions
Field label Feed targeting regions
Description Targeting regions
Field type dimension
Data type string.text.value
feed_targeting_relationship_statuses
Field label Feed targeting relation statuses
Description Targeting relationship statuses
Field type dimension
Data type string.text.value

LOCATION

country
Field label Country
Field type dimension
Data type string.geo.country.twolettercode
city
Field label City
Field type dimension
Data type string.geo.city
locale
Field label Language
Field type dimension
Data type string.language.locale

MESSAGING INSIGHTS

page_messages_total_messaging_connections
Field label Messaging connection count
Description The number of people who have sent a message to your business, not including people who have blocked or reported your business on Messenger
Field type metric
Data type int.number.value
page_messages_new_conversations_unique
Field label New conversations (unique)
Description The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before
Field type metric
Data type int.number.value
page_messages_blocked_conversations_unique
Field label Blocked conversations count (unique)
Description The number of conversations with the Page that have been blocked
Field type metric
Data type int.number.value
page_messages_reported_conversations_unique
Field label Reported conversations count (unique)
Description The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content
Field type metric
Data type int.number.value

PAGE

profile
Field label Page name
Field type dimension
Data type string.text.value
profileid
Field label Page ID
Field type dimension
Data type string.text.value

PAGE CONTENT MONETIZATION

page_total_monetization_earnings
Field label Total approximate earnings
Description Your total approximate earnings from all monetization programs you earned on your page
Field type metric
Data type float.number.value
page_content_monetization_earnings
Field label Content monetization earnings
Description Your approximate earnings from content monetization on your page
Field type metric
Data type float.number.value
page_instream_ads_earning
Field label Instream ads earnings
Description Your approximate earnings from In-Stream Ads run on videos on your page
Field type metric
Data type float.number.value
page_reels_ads_earnings
Field label Ads on reels earnings
Description Your approximate earnings from ads on Reels shown on your page
Field type metric
Data type float.number.value

PAGE LIKES

page_fans
Field label Total likes
Description The total number of people who have liked your Page
Field type metric
Data type int.number.value
page_fan_adds
Field label New likes
Description The number of new people who have liked your Page
Field type metric
Data type int.number.value
page_followers
Field label Page followers
Description Number of page followers
Field type metric
Data type int.number.value
page_fan_adds_unique
Field label New likes (unique users)
Description The number of new people who have liked your Page (Unique users)
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_fan_removes
Field label Unlikes
Field type metric
Data type int.number.value
page_fan_removes_unique
Field label Unlikes (unique users)
Description The number of Unlikes of your Page (Unique users)
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
NetFanGrowth
Field label Net likes
Description New likes minus unlikes
Field type metric
Data type int.number.value
FanGrowthRate
Field label Net likes growth rate
Description Growth rate of your page likes
Field type metric
Data type float.number.ratio
FanChurnRate
Field label Likes churn rate
Field type metric
Data type float.number.ratio

PAGE REACTIONS

page_post_reactions_total
Field label Total page reactions
Description Daily total post reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_like
Field label Page reactions: like
Description Daily total post "like" reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_love
Field label Page reactions: love
Description Daily total post "love" reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_wow
Field label Page reactions: wow
Description Daily total post "wow" reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_haha
Field label Page reactions: haha
Description Daily total post "haha" reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_sorry
Field label Page reactions: sorry
Description Daily total post "sorry" reactions of a page
Field type metric
Data type int.number.value
page_post_reactions_anger
Field label Page reactions: anger
Description Daily total post "anger" reactions of a page
Field type metric
Data type int.number.value

POST

post_ID
Field label Post ID
Field type dimension
Data type string.text.value
post_name
Field label Post name
Field type dimension
Data type string.text.value
post_creator
Field label Post creator
Description Name of post creator
Field type dimension
Data type string.text.value
post_linkto
Field label Link to post
Field type dimension
Data type string.text.url
post_type
Field label Post type
Field type dimension
Data type string.text.value
post_message
Field label Post message
Field type dimension
Data type string.text.value
post_story
Field label Post story
Field type dimension
Data type string.text.value
post_description
Field label Post description
Field type dimension
Data type string.text.value
post_status_type
Field label Post status type
Field type dimension
Data type string.text.value
post_privacy
Field label Post privacy
Field type dimension
Data type string.text.value
post_link
Field label Post shared link
Field type dimension
Data type string.text.url
post_object_id
Field label Post object ID
Field type dimension
Data type string.text.value
post_picture
Field label Post thumbnail URL
Field type dimension
Data type string.text.url
post_full_picture
Field label Post image URL
Field type dimension
Data type string.text.url
post_caption
Field label Post caption
Field type dimension
Data type string.text.value
post_story_tags
Field label Post story tags
Description The list of tags in the post description
Field type dimension
Data type string.text.value
post_video_length
Field label Post video length (s)
Field type dimension
Data type float.number.value
post_created_time_of_day
Field label Post creation time of day
Field type dimension
Data type string.time.hms

POST ACTIONS

post_likes_on_post
Field label Likes on post
Field type metric
Data type int.number.value
post_comments_on_post
Field label Comments on post
Field type metric
Data type int.number.value
post_comments_toplevel
Field label Top-level post comments
Field type metric
Data type int.number.value
post_shares_on_post
Field label Shares on post
Field type metric
Data type int.number.value
post_link_clicks
Field label Post link clicks
Field type metric
Data type int.number.value
post_other_clicks
Field label Post other clicks
Field type metric
Data type int.number.value
post_photo_views
Field label Post photo views
Field type metric
Data type int.number.value

POST COMMENT

post_comment_text
Field label Post comment text
Description The comment text
Field type dimension
Data type string.text.value
post_comment_author
Field label Post comment author
Description Author of the comment
Field type dimension
Data type string.text.value
post_comment_date
Field label Post comment date
Description Date of the comment
Field type dimension
Data type string.time.date
post_comment_time
Field label Post comment time
Description Time of the comment
Field type dimension
Data type string.time.hms

POST REACTIONS

post_reactions_total
Field label Total post reactions
Description Total post reactions by type
Field type metric
Data type int.number.value
post_reactions_like
Field label Post reactions: like
Description Total "like" reactions of a post
Field type metric
Data type int.number.value
post_reactions_love
Field label Post reactions: love
Description Total "love" reactions of a post
Field type metric
Data type int.number.value
post_reactions_wow
Field label Post reactions: wow
Description Total "wow" reactions of a post
Field type metric
Data type int.number.value
post_reactions_haha
Field label Post reactions: haha
Description Total "haha" reactions of a post
Field type metric
Data type int.number.value
post_reactions_sorry
Field label Post reactions: sad
Description Total "sorry" reactions of a post
Field type metric
Data type int.number.value
post_reactions_anger
Field label Post reactions: angry
Description Total "anger" reactions of a post
Field type metric
Data type int.number.value
post_reactions_thankful
Field label Post reactions: thankful
Field type metric
Data type int.number.value
post_reactions_pride
Field label Post reactions: pride
Field type metric
Data type int.number.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json

REACH

page_impressions_unique
Field label Total reach
Description The number of people who have seen any content associated with your Page
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_impressions_paid_unique
Field label Paid reach
Description Number of people who saw a sponsored story or Ad about your Page
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_impressions_viral_unique
Field label Viral reach
Description The number of people who saw your Page or one of its posts from a story published by a friend. These stories include liking your Page, posting to your Page's Timeline, liking, commenting on or sharing one of your Page posts, answering a Question you posted, RSVPing to one of your events, mentioning your Page, phototagging your Page or checking in at your Place
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_impressions_nonviral_unique
Field label Non-viral reach
Description The number of people who had any content from your Page enter their screen. This does not include content created about your Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
PaidReachPerc
Field label % of reach from paid
Description 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
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
ViralReachPerc
Field label % of reach from viral
Description The number of times any content from your Page or about your Page entered a person's screen with social information attached
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
NonViralReachPerc
Field label % of reach from non-viral
Description The number of times any content from your Page entered a person's screen
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
page_posts_impressions_unique
Field label Total reach of posts
Description The number of people who saw any of your Page posts
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_posts_impressions_paid_unique
Field label Paid reach of posts
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_posts_impressions_viral_unique
Field label Viral reach of posts
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_posts_impressions_nonviral_unique
Field label Non-viral reach of posts
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
FansReachedPerc
Field label Reach div. by page likers (fans)
Description Reach divided by likes of your page
Field type metric
Data type float.number.percentage
ViralReachAmplification
Field label Viral reach amplification %
Description Rate at which your reach was amplified by viral reach
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
NonViralReachAmplification
Field label Non-viral reach amplification %
Description Rate at which your reach was amplified by non-viral reach
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric
post_impressions_fan_unique
Field label Post reach (page likers [fans] only)
Field type metric
Data type int.number.value
post_impressions_fan
Field label Post impressions (page likers [fans] only)
Field type metric
Data type int.number.value
post_impressions_organic_unique
Field label Post organic reach
Description Counts reach from the organic distribution of your Facebook content, including posts, stories and ads. Reach from shares is counted towards organic content only
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
PostOrganicReachPerc
Field label % of reach from organic
Description Percentage of people who had your posts enter their screen through unpaid distribution
Field type metric
Data type float.number.percentage
Aggregation Non-aggregatable metric

REELS

reels_blue_reels_play_count
Field label Reels plays
Description The number of times your reel starts to play after an impression is already counted. This metric counts reels sessions with 1 millisecond or more of playback. This metric excludes replays
Field type metric
Data type int.number.value
reel_video_replay_count
Field label Reels replays
Description The number of times your reel starts to play again after an initial play of your reel. This is defined as replays of 1 millisecond or more in the same reel session
Field type metric
Data type int.number.value
reel_video_total_plays
Field label Total reels plays
Description The number of times your reel starts to play after an impression is already counted. This is defined as reel sessions with 1 millisecond or more and includes replays
Field type metric
Data type int.number.value
reels_impressions_unique
Field label Reels reach
Description The number of people who saw your reel at least once, whether or not the person played your reel. This metric is different from impressions, which includes multiple views of your reel by the same person. This metric is estimated
Field type metric
Data type int.number.value
reel_video_avg_time_watched
Field label Reels avg. time watched
Description The average number of milliseconds your reel was played during a single instance of playing it, including time spent replaying your reel. Because this metric includes replays, the value can be greater than the total length of the reel
Field type metric
Data type float.number.value
Aggregation Non-aggregatable metric
total_reel_video_reactions
Field label Reels total reactions
Description Total reels reactions by type
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_like
Field label Reels reactions: like
Description The number of reactions (likes) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_love
Field label Reels reactions: love
Description The number of reactions (love) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_care
Field label Reels reactions: care
Description The number of reactions (care) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_haha
Field label Reels reactions: haha
Description The number of reactions (haha) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_wow
Field label Reels reactions: wow
Description The number of reactions (wow) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_sad
Field label Reels reactions: sad
Description The number of reactions (sad) on your reel
Field type metric
Data type int.number.value
reel_video_likes_by_reaction_type_angry
Field label Reels reactions: angry
Description The number of reactions (angry) on your reel
Field type metric
Data type int.number.value
reel_video_social_actions_share
Field label Reels shares
Description The number of times your reel was shared
Field type metric
Data type int.number.value
reel_video_social_actions_comment
Field label Reels comments
Description The number of comments on your reel
Field type metric
Data type int.number.value
reel_video_view_time
Field label Reels total view time
Description The total number of milliseconds your reel played, including time spent replaying your reel
Field type metric
Data type float.number.value

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
Year
Field label Year
Description Year, e.g. 2017
Field type dimension
Data type string.time.year
Yearmonth
Field label Year & month
Description Year and month, e.g. 2017|06
Field type dimension
Data type string.time.yearmonth
Yearweek
Field label Year & week (Mon-Sun)
Description Year and week for ISO weeks, e.g. 2017|08
Field type dimension
Data type string.time.yearweek
Destinations Google Sheets
Quarter
Field label Quarter
Description Quarter, e.g. 1
Field type dimension
Data type string.time.quarter
Month
Field label Month
Description Month, e.g. 6
Field type dimension
Data type string.time.month
WeekISO
Field label Week (Mon-Sun)
Description ISO week number, e.g. 51
Field type dimension
Data type string.time.weekiso
Date
Field label Date
Description Date, e.g. 2017-01-31
Field type dimension
Data type string.time.date

VIDEO

video_id
Field label Video ID
Field type dimension
Data type string.text.value
video_universal_id
Field label Universal video identifier
Field type dimension
Data type string.text.value
video_title
Field label Video title
Field type dimension
Data type string.text.value
video_description
Field label Video description
Field type dimension
Data type string.text.value
video_content_category
Field label Video content category
Field type dimension
Data type string.text.value
video_live_status
Field label Video live status
Field type dimension
Data type string.text.value
video_published
Field label Video post publish status
Field type dimension
Data type bool
video_picture
Field label Video image URL
Field type dimension
Data type string.text.url
video_source
Field label Video source URL
Field type dimension
Data type string.text.url
video_permalink_url
Field label Video permalink URL
Field type dimension
Data type string.text.url
video_embeddable
Field label Video embeddable
Field type dimension
Data type bool
video_embed_html
Field label Video embed HTML
Field type dimension
Data type string.text.value
video_is_crossposting_eligible
Field label Video crossposting eligibility
Field type dimension
Data type bool
video_is_instagram_eligible
Field label Video Instagram eligibility
Field type dimension
Data type bool
video_length
Field label Video length (s)
Field type dimension
Data type float.number.value
video_created_time_of_day
Field label Video creation time of day
Field type dimension
Data type string.time.hms
video_backdated_time
Field label Video backdated time
Field type dimension
Data type string.text.value
video_backdated_time_granularity
Field label Video backdated time granularity
Field type dimension
Data type string.text.value

VIDEO 30-SECOND VIEWS

page_video_complete_views_30s
Field label Total 30s video views
Description Total number of times page's videos have been viewed for more than 30 seconds
Field type metric
Data type int.number.value
page_video_complete_views_30s_unique
Field label Unique 30s video views
Description The number of people who viewed your Page's videos for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Field type metric
Data type int.number.value
page_video_complete_views_30s_organic
Field label Organic 30s video views
Description The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, by organic reach
Field type metric
Data type int.number.value
page_video_complete_views_30s_paid
Field label Paid 30s video views
Description The number of times your Page's promoted videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Field type metric
Data type int.number.value
page_video_complete_views_30s_autoplayed
Field label Auto-played 30s video views
Description The number of times your Page's automatically played videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds
Field type metric
Data type int.number.value
page_video_complete_views_30s_click_to_play
Field label Clicked to play 30s video views
Description The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, after people clicked play
Field type metric
Data type int.number.value
page_video_watch_30s_rate
Field label Watch 30s rate
Field type metric
Data type float.number.ratio
page_video_watch_30s_rate_unique
Field label Unique watch 30s rate
Field type metric
Data type float.number.ratio
page_video_watch_30s_rate_organic
Field label Organic watch 30s rate
Field type metric
Data type float.number.ratio
page_video_watch_30s_rate_paid
Field label Paid watch 30s rate
Field type metric
Data type float.number.ratio
page_video_watch_30s_rate_autoplayed
Field label Auto-played watch 30s rate
Field type metric
Data type float.number.ratio
page_video_watch_30s_rate_click_to_play
Field label Clicked to play watch 30s rate
Field type metric
Data type float.number.ratio

VIDEO AD BREAK

page_daily_video_ad_break_ad_impressions_crossposted
Field label Page crossposted video ad break impressions
Description The total number of times an ad was shown during ad breaks in crossposted videos
Field type metric
Data type int.number.value
page_daily_video_ad_break_earnings_crossposted
Field label Page crossposted video ad break earnings
Description The average amount paid by advertisers for 1,000 of impressions of their ads in a crossposted videos. This is a gross number and includes the amount paid to Facebook
Field type metric
Data type float.number.value
page_daily_video_ad_break_cpm_crossposted
Field label Page crossposted video ad break CPM
Description An estimate of the amount you earned from ad breaks in crossposted videos, based on the number of impressions and CPM of ads shown
Field type metric
Data type float.number.value
page_daily_video_ad_break_ad_owned
Field label Page owned video ad break impressions
Description The total number of times an ad was shown during ad breaks in owned videos
Field type metric
Data type int.number.value
page_daily_video_ad_break_earnings_owned
Field label Page owned video ad break earnings
Description The average amount paid by advertisers for 1,000 of impressions of their ads in a owned videos. This is a gross number and includes the amount paid to Facebook
Field type metric
Data type float.number.value
page_daily_video_ad_break_cpm_owned
Field label Page owned video ad break CPM
Description An estimate of the amount you earned from ad breaks in owned videos, based on the number of impressions and CPM of ads shown
Field type metric
Data type float.number.value
post_video_ad_break_ad_impressions
Field label Post video ad break impressions
Description The total number of times an ad was shown during ad breaks in your videos
Field type metric
Data type int.number.value
post_video_ad_break_earnings
Field label Post video ad break earnings
Description The average amount paid by advertisers for 1,000 impressions of their ads in your videos. This number also includes the amount paid to Facebook
Field type metric
Data type float.number.value
post_video_ad_break_ad_cpm
Field label Post video ad break CPM
Description An estimate of the amount you earned from ad breaks in your videos, based on the number of impressions and CPM of ads shown
Field type metric
Data type float.number.value

VIDEO AD BREAK (VIDEO-DIMENSIONS ONLY)

total_video_ad_break_ad_impressions
Field label Total video ad break impressions
Description Number of times an ad was shown during your video's ad breaks
Field type metric
Data type int.number.value
total_video_ad_break_ad_cpm
Field label Total video ad break CPM
Description The average amount paid by advertisers for 1,000 impressions of their ads in your video, in U.S. cents. This number also includes the amount paid to Facebook
Field type metric
Data type float.currency.value
total_video_ad_break_earnings
Field label Total video ad break earnings
Description An estimate of the amount you earned from ad breaks in your video, in U.S. cents, based on the number of impressions and CPM of ads shown
Field type metric
Data type float.currency.value

VIDEO REACTIONS (VIDEO-DIMENSIONS ONLY)

video_reactions_total
Field label Total video reactions
Field type metric
Data type int.number.value
video_reactions_like
Field label Video reactions: like
Field type metric
Data type int.number.value
video_reactions_love
Field label Video reactions: love
Field type metric
Data type int.number.value
video_reactions_wow
Field label Video reactions: wow
Field type metric
Data type int.number.value
video_reactions_haha
Field label Video reactions: haha
Field type metric
Data type int.number.value
video_reactions_sorry
Field label Video reactions: sad
Field type metric
Data type int.number.value
video_reactions_anger
Field label Video reactions: angry
Field type metric
Data type int.number.value
video_reactions_thankful
Field label Video reactions: thankful
Field type metric
Data type int.number.value
video_reactions_pride
Field label Video reactions: pride
Field type metric
Data type int.number.value

VIDEO VIEWS

post_video_complete_views_organic
Field label Organic complete video views
Description The number of times your videos played from the beginning to 95%, or more, of its length, by organic reach
Field type metric
Data type int.number.value
post_video_complete_views_organic_unique
Field label Unique organic complete video views
Description The number of people who viewed your videos from the beginning to 95%, or more, of its length, by organic reach
Field type metric
Data type int.number.value
post_video_complete_views_paid
Field label Paid complete video views
Description The number of times your promoted videos played from the beginning to 95%, or more, of its length
Field type metric
Data type int.number.value
post_video_complete_views_paid_unique
Field label Unique paid complete video views
Description The number of people who viewed your promoted videos from the beginning to 95%, or more, of its length
Field type metric
Data type int.number.value
page_video_views
Field label Total video views
Description Total number of times page's videos have been viewed for more than 3 seconds
Field type metric
Data type int.number.value
page_video_views_unique
Field label Unique video views
Description Total number of times page's videos have been played for unique people for more than 3 seconds
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
page_video_views_organic
Field label Organic video views
Description Total number of times page's videos have been viewed for more than 3 seconds by organic reach
Field type metric
Data type int.number.value
page_video_views_paid
Field label Paid video views
Description Total number of times page's promoted videos have been viewed for more than 3 seconds
Field type metric
Data type int.number.value
page_video_views_autoplayed
Field label Auto-played video views
Description The number of times your videos automatically played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds
Field type metric
Data type int.number.value
page_video_views_click_to_play
Field label Clicked to play video views
Description The number of times your videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, after people clicked play
Field type metric
Data type int.number.value
post_video_views_sound_on
Field label Total video views with sound on
Description Number of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first
Field type metric
Data type int.number.value
post_video_view_time
Field label Total video view time (s)
Description The total number of seconds your video was watched, including replays and views less than 3 seconds. Returns 0 for reshared videos
Field type metric
Data type float.number.value
post_video_view_time_organic
Field label Organic video view time (s)
Description The total time, in milliseconds, your videos played by organic reach. Returns 0 for reshared videos
Field type metric
Data type float.number.value
post_video_view_time_paid
Field label Paid video view time (s)
Description The number of times your promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds
Field type metric
Data type float.number.value
avg_post_video_view_time
Field label Avg. video view time (s)
Description The average time, in milliseconds, people viewed your videos. Only available for videos created after August 25th 2016
Field type metric
Data type float.number.value
Aggregation Non-aggregatable metric
post_video_views_60s_excludes_shorter
Field label Total 60s video views
Description The number of times your videos played for at least 60 seconds. This metric is counted only for videos that are 60 seconds or longer
Field type metric
Data type int.number.value
post_video_views_15s
Field label Total 15s video views
Description 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
Field type metric
Data type int.number.value