> ## Documentation Index
> Fetch the complete documentation index at: https://support.detrics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Insights Metrics & Dimensions

> Complete reference for Facebook Page Insights dimensions and metrics

<Info>
  **Last updated:** October 1, 2026
</Info>

<div style={{display: "flex", gap: "8px", marginBottom: "20px"}}>
  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    49 dimensions
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    86 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Facebook Insights data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div style={{display: "flex", gap: "8px", marginBottom: "20px", alignItems: "center"}}>
  <span style={{fontSize: "14px", fontWeight: "500", color: "#6B7280"}}>Supported destinations:</span>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Google Sheets
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Looker Studio
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Claude
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Facebook Insights data.

### Page

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page ID</div> | The unique identifier of the page<br /><br />**Field Name:** `pageId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Name</div> | The name of the page<br /><br />**Field Name:** `pageName`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Link</div> | The URL link to the page<br /><br />**Field Name:** `pageLink`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Category</div> | The category of the page<br /><br />**Field Name:** `pageCategory`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Description</div> | The description of the page<br /><br />**Field Name:** `pageDescription`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page About</div> | The about section of the page<br /><br />**Field Name:** `pageAbout`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Phone</div> | The phone number of the page<br /><br />**Field Name:** `pagePhone`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Website</div> | The website URL of the page<br /><br />**Field Name:** `pageWebsite`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Hours</div> | The business hours of the page<br /><br />**Field Name:** `pageHours`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page City</div> | The city where the page is located<br /><br />**Field Name:** `pageCity`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Country</div> | The country where the page is located<br /><br />**Field Name:** `pageCountry`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Emails</div> | The email addresses of the page<br /><br />**Field Name:** `pageEmails`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Picture</div> | The profile picture URL of the page<br /><br />**Field Name:** `pagePicture`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Is Published</div> | Whether the page is published<br /><br />**Field Name:** `pageIsPublished`<br />**Type:** dimension |

### Post

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post ID</div> | The unique identifier of the post<br /><br />**Field Name:** `postId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Message</div> | The message content of the post<br /><br />**Field Name:** `postMessage`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Created Time</div> | The time the post was created<br /><br />**Field Name:** `postCreatedTime`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Permalink URL</div> | The permanent link URL to the post<br /><br />**Field Name:** `postPermalinkUrl`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Status Type</div> | The type of status update (e.g. mobile\_status\_update, added\_photos, added\_video)<br /><br />**Field Name:** `postStatusType`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Author Name</div> | The name of the user or page that created the post<br /><br />**Field Name:** `postFromName`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Author ID</div> | The ID of the user or page that created the post<br /><br />**Field Name:** `postFromId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Full Picture URL</div> | The full-sized picture URL attached to the post<br /><br />**Field Name:** `postFullPicture`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Attachment Type</div> | The type of attachment (e.g. photo, video, link)<br /><br />**Field Name:** `postAttachmentType`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Attachment URL</div> | The URL of the attachment<br /><br />**Field Name:** `postAttachmentUrl`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Attachment Description</div> | The description of the attachment<br /><br />**Field Name:** `postAttachmentDescription`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Media Product Type</div> | The type of content: REEL, PHOTO, ALBUM, or VIDEO. Derived from the post permalink and attachment type<br /><br />**Field Name:** `postMediaProductType`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Video ID</div> | The video ID for video posts. Empty for non-video posts. Use this to join with video-level data<br /><br />**Field Name:** `postVideoId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Is Published</div> | Whether the post is published<br /><br />**Field Name:** `postIsPublished`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Is Hidden</div> | Whether the post is hidden from timeline<br /><br />**Field Name:** `postIsHidden`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Is Expired</div> | Whether the post has expired<br /><br />**Field Name:** `postIsExpired`<br />**Type:** dimension |

### Post Comment

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comment ID</div> | The unique identifier of the comment<br /><br />**Field Name:** `postCommentId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comment Text</div> | The comment text<br /><br />**Field Name:** `postCommentText`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comment Author</div> | Author of the comment<br /><br />**Field Name:** `postCommentAuthor`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comment Date</div> | Date of the comment<br /><br />**Field Name:** `postCommentDate`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comment Time</div> | Time of the comment<br /><br />**Field Name:** `postCommentTime`<br />**Type:** dimension |

### Followers Demographics

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Followers City</div> | City where followers are located. Auto-added when using the Followers Count by City metric<br /><br />**Field Name:** `followersCity`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Followers Country</div> | Country code where followers are located (e.g. AR, US, BR). Auto-added when using the Followers Count by Country metric<br /><br />**Field Name:** `followersCountry`<br />**Type:** dimension |

### Video Demographics

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Viewer Gender</div> | Viewer gender (Female, Male, Unknown). Auto-added when using the Video View Time by Age & Gender metric<br /><br />**Field Name:** `videoGender`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Viewer Age</div> | Viewer age bucket (13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+). Auto-added when using the Video View Time by Age & Gender metric<br /><br />**Field Name:** `videoAgeBucket`<br />**Type:** dimension |

### Video Regions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Viewer Region</div> | Viewer region and country (e.g. "British Columbia - Canada"). Auto-added when using the Video View Time by Region metric<br /><br />**Field Name:** `videoRegion`<br />**Type:** dimension |

### Video Retention

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Second</div> | Second offset into the video (0, 1, 2, …). Auto-added when using the Video Retention metrics — one row per second of the video<br /><br />**Field Name:** `videoSecond`<br />**Type:** dimension |

### Video Distribution

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Distribution Type</div> | How the video reached viewers: page\_owned (posted by your Page), shared, or crossposted. Auto-added when using the Video Views by Distribution metric<br /><br />**Field Name:** `videoDistributionType`<br />**Type:** dimension |

### Lead

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lead ID</div> | The unique identifier of the lead<br /><br />**Field Name:** `leadId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Form ID</div> | The ID of the lead form<br /><br />**Field Name:** `formId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Form Name</div> | The name of the lead form<br /><br />**Field Name:** `formName`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lead Created Time</div> | The time the lead was created<br /><br />**Field Name:** `leadCreatedTime`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lead Ad ID</div> | The ID of the ad that generated the lead<br /><br />**Field Name:** `leadAdId`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lead Field Name</div> | The field name from the lead form<br /><br />**Field Name:** `leadName`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Lead Field Value</div> | The field value submitted in the lead form<br /><br />**Field Name:** `leadValue`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Facebook Insights campaigns.

### Page Posts

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic Impressions of Posts</div> | The number of times your Page's posts entered a person's screen through organic distribution<br /><br />**Field Name:** `page_posts_impressions_organic`<br />**Type:** metric |

### Page Engagement

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Post Engagements</div> | The number of times people have engaged with your posts through likes, comments and shares and more<br /><br />**Field Name:** `page_post_engagements`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Engaged Followers (Unique)</div> | The number of unique followers of your Page who engaged with it in the selected period<br /><br />**Field Name:** `page_lifetime_engaged_followers_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Total Actions</div> | The number of clicks on your Page's contact info and call-to-action button<br /><br />**Field Name:** `page_total_actions`<br />**Type:** metric |

### Page

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Fan Count</div> | The number of fans (likes) on the page. Returns a single snapshot of the current count. For historical daily tracking, use Page Followers instead<br /><br />**Field Name:** `pageFanCount`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Followers</div> | The total number of followers of your Facebook Page (follows minus unfollows). Available as a daily time series to track follower growth over time<br /><br />**Field Name:** `page_follows`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>New Followers</div> | The number of new follows of your Page in the selected period. Successor of the deprecated Page Fan Adds metric<br /><br />**Field Name:** `page_daily_follows`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>New Followers (Unique)</div> | The number of unique people who followed your Page in the selected period<br /><br />**Field Name:** `page_daily_follows_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unfollows (Unique)</div> | The number of unique people who unfollowed your Page in the selected period. Successor of the deprecated Page Fan Removes metric<br /><br />**Field Name:** `page_daily_unfollows_unique`<br />**Type:** metric |

### Page Views

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Visits</div> | The number of times a Page's profile has been viewed by logged in and logged out people<br /><br />**Field Name:** `page_views_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Views</div> | The number of times your content was played or displayed. Content includes videos, posts, stories and ads<br /><br />**Field Name:** `page_media_view`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Views Paid</div> | The number times paid distribution such as ads promoting your page was played or displayed<br /><br />**Field Name:** `page_media_view_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Views Organic</div> | The number of times your organic content was played or displayed. Content includes videos, posts, stories<br /><br />**Field Name:** `page_media_view_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Views Followers</div> | The number of times your content was played by or displayed to page followers<br /><br />**Field Name:** `page_media_view_followers`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Views Non-Followers</div> | The number of times your content was played by or displayed to non-followers<br /><br />**Field Name:** `page_media_view_non_followers`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Media Viewers</div> | The number of unique people who viewed any content from your Page. Meta's successor to the deprecated Reach metric — values may differ slightly from historical Reach as counting is now based on views rendered on screen<br /><br />**Field Name:** `page_total_media_view_unique`<br />**Type:** metric |

### Followers Demographics

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Followers Count by City</div> | Lifetime follower count broken down by city. Each city becomes a separate row with the followersCity dimension auto-added<br /><br />**Field Name:** `page_follows_city`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Followers Count by Country</div> | Lifetime follower count broken down by country. Each country becomes a separate row with the followersCountry dimension auto-added<br /><br />**Field Name:** `page_follows_country`<br />**Type:** metric |

### Page Reactions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Like</div> | Daily total post "like" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_like_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Love</div> | Daily total post "love" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_love_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Wow</div> | Daily total post "wow" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_wow_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Haha</div> | Daily total post "haha" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_haha_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Sorry</div> | Daily total post "sorry" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_sorry_total`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Page Reactions: Anger</div> | Daily total post "anger" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_anger_total`<br />**Type:** metric |

### Page Video

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Video Views</div> | Total number of times page's videos have been viewed for more than 3 seconds<br /><br />**Field Name:** `page_video_views`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unique Video Views</div> | Total number of times page's videos have been played for unique people for more than 3 seconds<br /><br />**Field Name:** `page_video_views_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic Video Views</div> | Total number of times page's videos have been viewed for more than 3 seconds by organic reach<br /><br />**Field Name:** `page_video_views_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Paid Video Views</div> | Total number of times page's promoted videos have been viewed for more than 3 seconds<br /><br />**Field Name:** `page_video_views_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Auto-Played Video Views</div> | The number of times your videos automatically played for at least 3 seconds<br /><br />**Field Name:** `page_video_views_autoplayed`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Clicked to Play Video Views</div> | The number of times your videos played for at least 3 seconds after people clicked play<br /><br />**Field Name:** `page_video_views_click_to_play`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Video View Time (ms)</div> | The total time, in milliseconds, that your Page's videos played, including videos played for less than 3 seconds and replays<br /><br />**Field Name:** `page_video_view_time`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Repeat Video Views</div> | The number of times your Page's videos replayed for at least 3 seconds after starting to play again in the same session<br /><br />**Field Name:** `page_video_repeat_views`<br />**Type:** metric |

### Page Video 30s

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total 30s Video Views</div> | Total number of times page's videos have been viewed for more than 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unique 30s Video Views</div> | The number of people who viewed your Page's videos for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic 30s Video Views</div> | The number of times your Page's videos played for at least 30 seconds by organic reach<br /><br />**Field Name:** `page_video_complete_views_30s_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Paid 30s Video Views</div> | The number of times your Page's promoted videos played for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Auto-Played 30s Video Views</div> | The number of times your Page's automatically played videos played for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_autoplayed`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Clicked to Play 30s Video Views</div> | The number of times your Page's videos played for at least 30 seconds after people clicked play<br /><br />**Field Name:** `page_video_complete_views_30s_click_to_play`<br />**Type:** metric |

### Messaging

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>New Conversations (Unique)</div> | The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before<br /><br />**Field Name:** `page_messages_new_conversations_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Blocked Conversations Count (Unique)</div> | The number of conversations with the Page that have been blocked<br /><br />**Field Name:** `page_messages_blocked_conversations_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Reported Conversations Count (Unique)</div> | The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content<br /><br />**Field Name:** `page_messages_reported_conversations_unique`<br />**Type:** metric |

### Post Actions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Total Clicks</div> | The number of times people clicked on anywhere in your posts without generating a story<br /><br />**Field Name:** `post_clicks`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Link Clicks</div> | The number of link clicks on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postLinkClicks`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Other Clicks</div> | The number of other clicks on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postOtherClicks`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Photo Views</div> | The number of photo views on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postPhotoViews`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Likes on Post</div> | The number of likes on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postLikesOnPost`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Comments on Post</div> | The number of comments on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postCommentsOnPost`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Shares on Post</div> | The number of shares on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postSharesOnPost`<br />**Type:** metric |

### Post Reactions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Post Reactions</div> | Total post reactions by type<br /><br />**Field Name:** `postReactionsTotal`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Post Comments</div> | Total comments on the post<br /><br />**Field Name:** `postCommentsTotal`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Like</div> | Total "like" reactions of a post<br /><br />**Field Name:** `postReactionsLike`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Love</div> | Total "love" reactions of a post<br /><br />**Field Name:** `postReactionsLove`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Wow</div> | Total "wow" reactions of a post<br /><br />**Field Name:** `postReactionsWow`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Haha</div> | Total "haha" reactions of a post<br /><br />**Field Name:** `postReactionsHaha`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Sad</div> | Total "sad" reactions of a post<br /><br />**Field Name:** `postReactionsSad`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Angry</div> | Total "angry" reactions of a post<br /><br />**Field Name:** `postReactionsAngry`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Thankful</div> | Total "thankful" reactions of a post<br /><br />**Field Name:** `postReactionsThankful`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Pride</div> | Total "pride" reactions of a post<br /><br />**Field Name:** `postReactionsPride`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Reactions: Care</div> | Total "care" reactions of a post<br /><br />**Field Name:** `postReactionsCare`<br />**Type:** metric |

### Post Views

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Media Viewers</div> | The number of unique people who viewed media on this post. Meta's successor to the deprecated Post Reach metric<br /><br />**Field Name:** `post_total_media_view_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Post Media Views</div> | The number of times media on this post was played or displayed. Post-level counterpart of Page Media Views, and Meta's successor to the deprecated Post Impressions metric<br /><br />**Field Name:** `post_media_view`<br />**Type:** metric |

### Post Video

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Post Video Views</div> | The number of times your video was viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic Post Video Views</div> | The number of times your video was viewed for 3 seconds or more by organic reach<br /><br />**Field Name:** `post_video_views_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Paid Post Video Views</div> | The number of times your promoted video was viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unique Post Video Views</div> | The number of unique people who viewed your video for 3 seconds or more<br /><br />**Field Name:** `post_video_views_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Autoplayed Post Video Views</div> | The number of times your video was auto-played and viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views_autoplayed`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Clicked-to-Play Post Video Views</div> | The number of times a user clicked to play your video and viewed it for 3 seconds or more<br /><br />**Field Name:** `post_video_views_clicked_to_play`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic Complete Video Views</div> | The number of times your videos played from the beginning to 95%, or more, of its length, by organic reach<br /><br />**Field Name:** `post_video_complete_views_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unique Organic Complete Video Views</div> | The number of people who viewed your videos from the beginning to 95%, or more, of its length, by organic reach<br /><br />**Field Name:** `post_video_complete_views_organic_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Paid Complete Video Views</div> | The number of times your promoted videos played from the beginning to 95%, or more, of its length<br /><br />**Field Name:** `post_video_complete_views_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unique Paid Complete Video Views</div> | The number of people who viewed your promoted videos from the beginning to 95%, or more, of its length<br /><br />**Field Name:** `post_video_complete_views_paid_unique`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Video Views with Sound On</div> | Number of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first<br /><br />**Field Name:** `post_video_views_sound_on`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Organic Video View Time (s)</div> | The total time, in milliseconds, your videos played by organic reach. Returns 0 for reshared videos<br /><br />**Field Name:** `post_video_view_time_organic`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Paid Video View Time (s)</div> | The number of times your promoted videos played for at least 3 seconds, or for nearly their total length if they are shorter than 3 seconds<br /><br />**Field Name:** `post_video_view_time_paid`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Post Video View Time (ms)</div> | The total time, in milliseconds, your video played, including replays and views under 3 seconds. Organic plus paid<br /><br />**Field Name:** `post_video_view_time`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Avg Video Time Watched (ms)</div> | The average time, in milliseconds, people spent watching your video. Compare against Video Length to measure completion quality<br /><br />**Field Name:** `post_video_avg_time_watched`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Length (ms)</div> | The duration of the post video in milliseconds<br /><br />**Field Name:** `post_video_length`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total 60s Video Views</div> | 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<br /><br />**Field Name:** `post_video_views_60s_excludes_shorter`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total 15s Video Views</div> | The number of times your videos played for at least 15 seconds, or for nearly their total length if they are shorter than 15 seconds<br /><br />**Field Name:** `post_video_views_15s`<br />**Type:** metric |

### Video Demographics

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video View Time by Age & Gender (ms)</div> | Total video view time in milliseconds broken down by viewer age bucket and gender. Each combination becomes a separate row with the Viewer Gender and Viewer Age dimensions auto-added<br /><br />**Field Name:** `post_video_view_time_by_age_bucket_and_gender`<br />**Type:** metric |

### Video Regions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video View Time by Region (ms)</div> | Total video view time in milliseconds broken down by viewer region. Each region becomes a separate row with the Viewer Region dimension auto-added<br /><br />**Field Name:** `post_video_view_time_by_region_id`<br />**Type:** metric |

### Video Retention

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Retention</div> | Fraction of viewers (0–1) still watching at each second of the video. One row per second with the Video Second dimension auto-added — chart it to see where viewers drop off<br /><br />**Field Name:** `post_video_retention_graph`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Retention (Auto-Played)</div> | Fraction of viewers (0–1) still watching at each second, counting only auto-played views. Combinable with the other Video Retention metrics on the same rows<br /><br />**Field Name:** `post_video_retention_graph_autoplayed`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Retention (Clicked to Play)</div> | Fraction of viewers (0–1) still watching at each second, counting only clicked-to-play views. Combinable with the other Video Retention metrics on the same rows<br /><br />**Field Name:** `post_video_retention_graph_clicked_to_play`<br />**Type:** metric |

### Video Distribution

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views by Distribution</div> | Video views broken down by how the video reached viewers (page\_owned, shared, crossposted). Each type becomes a separate row with the Distribution Type dimension auto-added<br /><br />**Field Name:** `post_video_views_by_distribution_type`<br />**Type:** metric |

### Lead

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Form Leads Count</div> | The number of leads collected by the form<br /><br />**Field Name:** `formLeadsCount`<br />**Type:** metric |

***

## Related

<CardGroup cols={2}>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog/index">
    Browse all platforms
  </Card>

  <Card title="Instagram Insights Fields" icon="chart-bar" href="/data-source/instagram-insights/fields">
    Instagram Insights metrics & dimensions
  </Card>

  <Card title="Facebook Public Data Fields" icon="chart-bar" href="/data-source/facebook-public-data/fields">
    Facebook Public Data metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.