Pull total social metrics across channels

Pull aggregated KPIs like impressions, followers, and reach across all connected channels. Use this to populate BI dashboards or build high-level performance reports.

Use cases

Building executive dashboards manually takes hours. Metric reports pull totals across all channels in seconds.

Executive Dashboard

Build weekly performance reports in Looker showing Instagram follower growth and reach across all brands

Quarterly Review

Export Q4 engagement totals for every brand to present performance trends to leadership

Cross-Channel Analysis

Compare your TikTok views against Instagram reach to identify which platform drives more brand awareness

Before you start

Make sure you have:

API access token with permissions to the relevant brand.
Brand ID for the account you want to query.

See API Quickstart for more details. Supported platforms This report supports these channels:

Instagram (including Stories)
TikTok
Facebook
YouTube
Pinterest
Twitter (X)
LinkedIn

About metric reports Metric reports return aggregated totals. You get one summary number per metric (like total followers or total reach). No breakdown by day, week, or individual post. Perfect for headline KPIs on executive dashboards.

Test in the UI first: Create a Dashboard in the Dash Social UI and configure your report there. This previews the metrics and validates your filters before writing code.

Implementation

Step 1: Map your parameters

Deprecation notice: The SINGLE_METRIC report type is being sunset and will be replaced by TOTAL_METRIC. Update your integrations to use TOTAL_METRIC to avoid future breaking changes.

Review the available parameters before making your API call:

Step 2: Make the API call

Send a GET request using the parameters from Step 1. This example pulls views and total followers for brand 144 on Instagram from May 1-7, with April 1-7 as the comparison period.

GET https://dashboard.dashsocial.com/reports/data
  ?channels=INSTAGRAM
  &brand_ids=144
  &start_date=2025-05-01
  &end_date=2025-05-07
  &context_start_date=2025-04-01
  &context_end_date=2025-04-07
  &metrics=VIEWS,TOTAL_FOLLOWERS
  &report_type=TOTAL_METRIC

Key query parameters

brand_ids: Brand(s) to report on. Separate multiple IDs with commas (e.g., 144,145,146)
channels: Social platforms to include. Use the API names from Step 1. Request multiple channels in one call by separating them with commas
metrics: Metrics you want totals for. Common options: views, followers, engagements, reach, impressions. See the full API reference for the complete list with API key names
report_type: Set to TOTAL_METRIC
start_date / end_date: Reporting period in YYYY-MM-DD format
context_start_date / context_end_date: Comparison period for trend analysis. Use same dates if comparison isn’t needed. Otherwise, choose an earlier period of the same length

Multiple metrics

Request multiple metrics in a single call by separating them with commas (e.g., VIEWS,TOTAL_FOLLOWERS,TOTAL_ENGAGEMENTS).

Date format matters: Always use YYYY-MM-DD format for dates (e.g., 2025-05-01). Other formats will cause errors.

Common errors:

400 error - Check that dates are in YYYY-MM-DD format, metrics are valid for your channels, and brand_id exists
Invalid date format - Use YYYY-MM-DD format. 2025-05-01 works, 05/01/2025 doesn’t
Missing brand ID - Verify your brand ID is correct. Get it from your account settings

Sample response

The API returns totals for each metric, organized by brand and channel. The value field shows your reporting period total. The context field shows your comparison period total.

{
  "data": {
    "144": {
      "name": "sunny.today",
      "metrics": {
        "TOTAL_FOLLOWERS": {
          "INSTAGRAM": {
            "value": 67.0,
            "context": 68.0
          }
        },
        "VIEWS": {
          "INSTAGRAM": {
            "value": 408.0,
            "context": 270.0
          }
        }
      }
    }
  }
}

Understanding the response: Metrics are organized by brand ID and channel. Brand 144 (“sunny.today”) had 67 total followers on Instagram during May 1-7 (down from 68 during April 1-7) and received 408 views (up from 270 in April).

Querying multiple brands and channels

When you query multiple brands across multiple channels, add aggregate_by=BRAND and secondary_aggregate_by=CHANNEL to control how the response is grouped. Without these parameters, the grouping depends on the report type and request context, which may not match what you expect.

GET https://dashboard.dashsocial.com/reports/data
  ?channels=INSTAGRAM,FACEBOOK
  &brand_ids=144,145
  &start_date=2025-05-01
  &end_date=2025-05-07
  &context_start_date=2025-04-01
  &context_end_date=2025-04-07
  &metrics=VIEWS,TOTAL_FOLLOWERS
  &report_type=TOTAL_METRIC
  &aggregate_by=BRAND
  &secondary_aggregate_by=CHANNEL

The response nests channel data under a breakdowns key inside each brand:

{
  "data": {
    "144": {
      "data_type": "BRAND",
      "name": "sunny.today",
      "breakdowns": {
        "INSTAGRAM": {
          "data_type": "CHANNEL",
          "name": "Instagram",
          "metrics": {
            "TOTAL_FOLLOWERS": {
              "INSTAGRAM": {
                "value": 67.0,
                "context": 68.0
              }
            },
            "VIEWS": {
              "INSTAGRAM": {
                "value": 408.0,
                "context": 270.0
              }
            }
          }
        }
      }
    },
    "metrics": {
      "TOTAL_FOLLOWERS": {
        "ALL_CHANNELS": {
          "value": 67.0,
          "context": 68.0
        }
      },
      "VIEWS": {
        "ALL_CHANNELS": {
          "value": 408.0,
          "context": 270.0
        }
      }
    }
  }
}

Read metrics from each entry using the path data.<brand_id>.breakdowns.<CHANNEL>.metrics.<METRIC>.<CHANNEL>. The top-level metrics object contains totals across all brands and channels.

Metrics

Metric Name	Description	Post Types	Metric API Name
Accounts Engaged	The number of accounts that have interacted with your organic and promoted posts during the reporting period		`ACCOUNTS_ENGAGED`
Accounts Reached	The number of unique accounts that have seen your content. Estimated by Instagram. This total may not equal the sum of follower and non-follower reach due to differences in how Instagram samples and estimates the metric. Note: Instagram account-level metrics include Instagram Stories stats.		`ACCOUNTS_REACHED`
Accounts Reached (Followers)	The number of unique follower accounts that have seen your content. Estimated by Instagram. Note: Instagram account-level metrics include Instagram Stories stats.		`ACCOUNTS_REACHED_FOLLOWERS`
Accounts Reached (Non-Followers)	The number of unique non-follower accounts that have seen your content. Estimated by Instagram. Note: Instagram account-level metrics include Instagram Stories stats.		`ACCOUNTS_REACHED_NON_FOLLOWERS`
Ad Engagements - Paid	The total number of ad engagements your promoted posts received	Promoted	`AD_ENGAGEMENTS`
Avg. Time Watched - Organic	The average time your videos were played during a single viewing	Organic	`AVG_AVG_WATCH_TIME`
Avg. Effectiveness - Organic	The average percentage of users that saw your posts and engaged with them Avg. Effectiveness = Engagements / Reach	Organic	`AVG_EFFECTIVENESS_ENGAGEMENTS`
Avg. Engagement Rate (Followers) - Organic	The average percentage of your audience that engaged with your posts published during the Reporting Period. Engagement Rate = Organic Engagements / Followers	Organic	`AVG_ENGAGEMENT_RATE`
Avg. Engagement Rate (Views) - Organic	The average percentage of your audience that engaged with your posts published during the Reporting Period. Engagement Rate = Organic Engagements / Views	Organic	`AVG_ENGAGEMENT_RATE_VIEWS`
Avg. Entertainment Score - Organic	The average Entertainment Score of your Reels published during the reporting period. The score is on a scale of 0 to 10 and is based on volume of organic engagements compared to reach.	Organic	`AVG_ENTERTAINMENT_SCORE`
Avg. Reach - Total	The average number of unique accounts that saw your posts	Organic + Promoted	`AVG_PAID_AND_ORGANIC_REACH`
Engagement Rate (Impressions) - Paid	The promoted engagement rate on your posts this period	Promoted	`AVG_PAID_ENGAGEMENT_RATE`
Avg. Reach - Paid	The average number of unique accounts that saw your posts	Promoted	`AVG_PAID_REACH`
Avg. Reach - Organic	The average number of unique accounts that saw your posts published during the Reporting Period	Organic	`AVG_REACH`
Avg. Skip Rate - Organic	The average percentage of viewers who skipped your Reels within the first 3 seconds	Organic	`AVG_REELS_SKIP_RATE`
Book Now Clicks - All Posts	The number of times people tapped the Book Now button on your profile after viewing your posts		`BOOK_NOW_CLICKS`
Call Clicks - All Posts	The number of times people tapped the call button on your profile after viewing your posts		`CALL_CLICKS`
Clicks - Paid	The total number of clicks on your promoted posts. This can include link clicks, clicks to your profile, and more.	Promoted	`CLICKS`
Avg. CTR - Paid	The average percentage of times people clicked your promoted posts after seeing them	Promoted	`CLICK_THROUGH_RATE`
Comments - Total - All Posts	The number of comments your posts received. Note: Instagram account-level metrics include Instagram Stories stats.	Organic + Promoted	`COMMENTS_ACCOUNT_STATS`
Post Sentiment - Negative	The percentage of posts published during the reporting period with an overall negative comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE`
Post Sentiment - Negative	The percentage of posts with a negative overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEGATIVE_RATE_ORGANIC`
Post Sentiment - Negative	The percentage of posts with a negative overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE_PROMOTED`
Post Sentiment - Neutral	The percentage of posts published during the reporting period with an overall neutral comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE`
Post Sentiment - Neutral	The percentage of posts with a neutral overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEUTRAL_RATE_ORGANIC`
Post Sentiment - Neutral	The percentage of posts with a neutral overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE_PROMOTED`
Post Sentiment - Positive	The percentage of posts published during the reporting period with an overall positive comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE`
Post Sentiment - Positive	The percentage of posts with a positive overall comment sentiment	Organic	`COMMENT_SENTIMENT_POSITIVE_RATE_ORGANIC`
Post Sentiment - Positive	The percentage of posts with a positive overall comment sentiment	Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE_PROMOTED`
Content Engagements - All Posts	The number of likes, comments, shares, and saves your content received during the reporting period. Note: Instagram account-level metrics include Instagram Stories stats.		`CONTENT_ENGAGEMENTS`
Engagement Rate (Views) - All Posts	The percentage of people who engaged with your content after viewing it		`CONTENT_ENGAGEMENT_RATE_VIEWS`
Avg. CPC - Paid	The average cost per click on your promoted posts	Promoted	`COST_PER_CLICK`
Avg. CPM - Paid	The average cost per 1,000 impressions on your promoted posts	Promoted	`COST_PER_MILE`
Views - Crossposted - Organic	Total views across Instagram and Facebook for content crossposted natively between platforms. For Reels, includes views from crossposting or cross-app recommendations, where Reels appear on Facebook under your Instagram username.	Organic	`CROSSPOSTED_VIEWS`
Views - Facebook - Organic	The number of views your posts received on Facebook, for content crossposted natively from Instagram. For Reels, also includes views from cross-app recommendations, where Reels appear on Facebook under your Instagram username.	Organic	`FACEBOOK_VIEWS`
Followers - Lost	The total numbers of users who unfollowed your account during the Reporting Period. *Lost Followers data is received once per day in the Pacific Timezone.		`FOLLOWERS_LOST`
Followers - Growth Rate	The percentage your followers increased by during the Reporting Period. Follower Growth Rate = (New Followers - Old Followers) / Old Followers x 100%		`FOLLOWER_GROWTH_RATE`
Follows - Organic	The number of accounts that started following you after viewing your post	Organic	`FOLLOWS`
LikeShop Clicks - All Posts	The total number of clicks on any LikeShop feed products during the reporting period		`LIKESHOP_CLICKS`
LikeShop Clicks	The number of clicks on your LikeShop feed products on posts published during the reporting period		`LIKESHOP_CLICKS_BY_POST`
LikeShop Contact Submissions - All Posts	The number of email submissions during the reporting period		`LIKESHOP_CONTACT_SUBMISSIONS`
LikeShop CTR - All Posts	The percentage of times people clicked your product links after viewing your post		`LIKESHOP_CTR`
LikeShop Posts	The number of posts you’ve published during the reporting period that include product links. These are the posts visible on your LikeShop.		`LIKESHOP_POSTS`
LikeShop Views - All Posts	The number of times your posts were displayed on a person’s screen. This includes repeat views.		`LIKESHOP_VIEWS`
Likes - Total - All Posts	The number of likes your posts received. Note: Instagram account-level metrics include Instagram Stories stats.	Organic + Promoted	`LIKES_ACCOUNT_STATS`
Followers - Net New	The net new number of people who have followed your account		`NET_NEW_FOLLOWERS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic + Promoted	`NUMBER_OF_POSTS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic	`NUMBER_OF_POSTS_ORGANIC`
Number of Posts	The number of posts you’ve published during the reporting period	Promoted	`NUMBER_OF_POSTS_PAID`
Follower Activity - All Posts	The average times your followers were active during the reporting period. Data from the Instagram API may be delayed by up to 3 days.		`ONLINE_FOLLOWERS`
Comments - Organic	The number of comments on your posts published during the reporting period	Organic	`ORGANIC_COMMENTS`
Likes - Organic	The number of likes received on posts published during the reporting period	Organic	`ORGANIC_LIKES`
Comments - Paid	The number of comments your posts received	Promoted	`PAID_COMMENTS`
Cost per ThruPlay - Paid	The average cost per Thruplay for your videos	Promoted	`PAID_COST_PER_THRUPLAY`
Impressions - Paid	The number of times your posts were viewed or displayed	Promoted	`PAID_IMPRESSIONS`
Likes - Paid	The number of likes your posts received	Promoted	`PAID_LIKES`
Saves - Paid	The number of times your posts were saved	Promoted	`PAID_SAVES`
Shares - Paid	The number of times your promoted posts were shared	Promoted	`PAID_SHARES_BY_POST`
Engagements - Paid	The total number of engagements your promoted posts received	Promoted	`PAID_TOTAL_ENGAGEMENTS`
Video Views - Paid	The number of times your videos were viewed	Promoted	`PAID_VIDEO_VIEWS`
Profile Clicks - Organic	The number of actions people take when they visit your profile after viewing your post. This can include bio link clicks, calls, emails, and more.	Organic	`PROFILE_CLICKS`
Profile Bio Link Clicks	The number of times people clicked the link in your profile bio after viewing your post	Organic	`PROFILE_CLICKS_BIO`
Profile Call Clicks - Organic	The number of times people tapped the call button on your profile after viewing your posts	Organic	`PROFILE_CLICKS_CALL`
Profile Directions Clicks - Organic	The number of times people clicked to get directions from your profile after viewing your posts	Organic	`PROFILE_CLICKS_DIRECTIONS`
Profile Email Clicks	The number of times people tapped the email button on your profile after viewing your posts	Organic	`PROFILE_CLICKS_EMAIL`
Profile Other Clicks - Organic	The number of times people clicked other profile buttons after viewing your posts	Organic	`PROFILE_CLICKS_OTHER`
Profile Text Clicks	The number of times people tapped the text message button on your profile after viewing your posts	Organic	`PROFILE_CLICKS_TEXT`
Profile Views	The amount of times your profile has been viewed during the Reporting Period		`PROFILE_VIEWS`
Profile Visits - Organic	The number of times your profile was visited after viewing your post	Organic	`PROFILE_VISITS`
Reposts - Organic	The number of times your posts have been reposted	Organic	`REPOSTS`
Reposts - Organic - All Posts	The number of times your posts have been reposted, minus any un-reposts. This metric can be negative if un-reposts exceed reposts. Note: Instagram account-level metrics include Instagram Stories stats.	Organic	`REPOSTS_ACCOUNT_STATS`
Saves - Organic	The number of times your posts published during the reporting period were saved	Organic	`SAVES`
Saves - Total - All Posts	The number of times your posts were saved. Note: Instagram account-level metrics include Instagram Stories stats.	Organic + Promoted	`SAVES_ACCOUNT_STATS`
Shares - Organic	The number of times your posts published were shared during the reporting period	Organic	`SHARES`
Shares - Total - All Posts	The number of times your posts were shared. Note: Instagram account-level metrics include Instagram Stories stats.	Organic + Promoted	`SHARES_ACCOUNT_STATS`
Engagements - Total	The total number of engagements from all posts published during the Reporting Period	Organic + Promoted	`SUM_TOTAL_ENGAGEMENTS`
ThruPlays - Paid	The number of times your videos were watched to completion or for at least 15 seconds	Promoted	`THRUPLAYS`
Comments - Total	The number of comments your posts received	Organic + Promoted	`TOTAL_COMMENTS`
Engagements - Organic	The total number of engagements on your posts published during the reporting period Engagements = (Likes + Saves + Comments + Shares) - (Unlikes + Unsaves + Deleted comments)	Organic	`TOTAL_ENGAGEMENTS`
Followers	The total number of followers you have on this channel		`TOTAL_FOLLOWERS`
Likes - Total	The number of likes your posts received	Organic + Promoted	`TOTAL_LIKES`
Saves - Total	The number of times your posts were saved	Organic + Promoted	`TOTAL_SAVES`
Shares - Total	The number of times your posts were shared	Organic + Promoted	`TOTAL_SHARES`
Amount Spent - Paid	The total amount of money you’ve spent boosting your posts. Due to API delays, recent spend figures may be estimated for up to 48 hours.	Promoted	`TOTAL_SPENT`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Video Plays 100% - Paid	The number of times your videos were played to 100% of their length, including plays that skipped to this point	Promoted	`VIDEO_PLAYS_100`
Video Plays 25% - Paid	The number of times your videos were played to 25% of their length, including plays that skipped to this point	Promoted	`VIDEO_PLAYS_25`
Video Plays 50% - Paid	The number of times your videos were played to 50% of their length, including plays that skipped to this point	Promoted	`VIDEO_PLAYS_50`
Video Plays 75% - Paid	The number of times your videos were played to 75% of their length, including plays that skipped to this point	Promoted	`VIDEO_PLAYS_75`
Views - Organic	The number of times your posts were displayed on a person’s screen. This includes repeat views.	Organic	`VIEWS`
Views - All Posts	The number of times your posts were viewed or displayed. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric. Note: Instagram account-level metrics include Instagram Stories stats.		`VIEWS_ALL_ACCOUNT_STATS`
Views (Followers) - All Posts	The number of times your posts were viewed by your followers during the reporting period. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric. Note: Instagram account-level metrics include Instagram Stories stats.		`VIEWS_FOLLOWERS_ACCOUNT_STATS`
Views (Non-Followers) - All Posts	The number of times your posts were viewed by non-followers during the reporting period. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric. Note: Instagram account-level metrics include Instagram Stories stats.		`VIEWS_NON_FOLLOWERS_ACCOUNT_STATS`
Total Time Watched - Organic	The sum of the time that all viewers watched your videos for	Organic	`WATCH_TIME`

Metric Name	Description	Post Types	Metric API Name
Accounts Reached	The number of unique accounts that have seen your content. Estimated by Instagram. This total may not equal the sum of follower and non-follower reach due to differences in how Instagram samples and estimates the metric.		`ACCOUNTS_REACHED`
Accounts Reached (Followers)	The number of unique follower accounts that have seen your content. Estimated by Instagram.		`ACCOUNTS_REACHED_FOLLOWERS`
Accounts Reached (Non-Followers)	The number of unique non-follower accounts that have seen your content. Estimated by Instagram.		`ACCOUNTS_REACHED_NON_FOLLOWERS`
Avg. Completion Rate	The average percentage of people who viewed the entire story. Completion Rate = (Exits - Views) / Views. This metric is only available for reporting after March 24, 2025.	Organic	`AVG_COMPLETION_RATE_VIEWS`
Avg. Exit Rate	The percentage of people who exited out of the story. Exit Rate = Exits / Views. This metric is only available for reporting after March 24, 2025.	Organic	`AVG_EXIT_RATE_VIEWS`
Avg. Reach	The average number of unique accounts that saw your stories published during the Reporting Period.	Organic	`AVG_REACH`
Comments - All Posts	The number of comments your posts received		`COMMENTS_ACCOUNT_STATS`
Content Engagements - All Posts	The number of likes, comments, shares, and saves your content received during the reporting period		`CONTENT_ENGAGEMENTS`
Exits	The number of times that a user has swiped out of the story or tapped the X in the upper-right corner of the story frame published during the reporting period. An exit is counted even if it occurred in the last millisecond.	Organic	`EXITS`
Likes - All Posts	The number of likes your posts received		`LIKES_ACCOUNT_STATS`
Number of Story Frames	The number of posts you’ve published during the reporting period	Organic	`NUMBER_OF_POSTS`
Replies	The number of times people replied to your Instagram Stories published during the reporting period. Due to API restrictions, replies from accounts in the European Economic Area (EEA) or Japan are not included. For Stories created in the EEA or Japan, replies return a value of 0.	Organic	`REPLIES`
Saves - All Posts	The number of times your posts were saved		`SAVES_ACCOUNT_STATS`
Shares - All Posts	The number of times your posts were shared		`SHARES_ACCOUNT_STATS`
Replies - All Posts	The number of replies your story frames received	Organic + Promoted	`STORY_REPLIES`
Stories Link Clicks	The number of link clicks on the story frames published during during the reporting period. Only links scheduled through Dash are trackable via the platform.	Organic	`SWIPE_UPS`
Taps Back	The number of people who tapped backwards on your stories published during the reporting period	Organic	`TAPS_BACK`
Taps Forward	The number of people who tapped forward on your stories published during the reporting period	Organic	`TAPS_FORWARD`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Views	The number of times your story frames published during the reporting period was displayed on a person’s screen. This includes repeat views This metric is only available for reporting after March 24, 2025.	Organic	`VIEWS`
Views - All Posts	The number of times your posts were viewed or displayed. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric.		`VIEWS_ALL_ACCOUNT_STATS`
Views (Followers) - All Posts	The number of times your posts were viewed by your followers during the reporting period. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric.		`VIEWS_FOLLOWERS_ACCOUNT_STATS`
Views (Non-Followers) - All Posts	The number of times your posts were viewed by non-followers during the reporting period. The sum of follower and non-follower views may not add to the Total due to differences in how Instagram samples and estimates the metric.		`VIEWS_NON_FOLLOWERS_ACCOUNT_STATS`

Metric Name	Description	Post Types	Metric API Name
Avg. Completion Rate - Total	The average percentage of viewers that watched each organic and promoted video published during the reporting period to completion	Organic + Promoted	`AVG_COMPLETION_RATE`
Avg. Engagement Rate (Reach) - Total	The average Engagement Rate of your organic and promoted videos published during the reporting period. Engagement Rate = Total Engagements / Reach	Organic + Promoted	`AVG_ENGAGEMENT_RATE`
Avg. Entertainment Score - Total	The average Entertainment Score of your organic and promoted videos during the reporting period. The score is on a scale of 0 to 10 and takes the engagement and retention rate of each video into account. Scores are generated 48 hours after publishing.	Organic + Promoted	`AVG_ENTERTAINMENT_SCORE`
Avg. FYP Views - Total	The average percentage of views that came from the For You page for organic and promoted videos published during the reporting period	Organic + Promoted	`AVG_FYP_VIEWS`
Avg. Likes - Organic	The average number of likes your organic posts received. Important: This metric stops updating when ad promotions end.	Organic	`AVG_ORGANIC_LIKES`
Avg. Reach - Est. Organic	The estimated number of people who watched your video at least once through organic reach. If not all Ad accounts are connected, organic reach may be underreported. Important: This metric stops updating when ad promotions end. Due to API limitations, the sum of organic + promoted Reach may not match the Reach metric once the promotions stop.	ESTIMATED_ORGANIC	`AVG_ORGANIC_REACH`
Avg. Shares - Organic	The average number of times your organic posts were shared. Important: This metric stops updating when ad promotions end.	Organic	`AVG_ORGANIC_SHARES`
Avg. Video Views - Est. Organic	The estimated average number of times viewers watched your video through organic reach. Includes replays and multiple views from the same viewer. Important: This metric stops updating when ad promotions end. Due to API limitations, this is an estimated value and the sum of organic + promoted views may not match the Video Views metric once the promotions end.	ESTIMATED_ORGANIC	`AVG_ORGANIC_VIDEO_VIEWS`
Avg. Engagement Rate (Reach) - Paid	The percentage of people who engaged with your promoted posts after seeing them. Important: This metric stops updating when ad promotions end.	Promoted	`AVG_PAID_ENGAGEMENT_RATE`
Avg. Likes - Paid	The average number of likes your promoted posts received. Important: This metric stops updating when ad promotions end.	Promoted	`AVG_PAID_LIKES`
Avg. Reach - Paid	The estimated number of people who watched your video at least once through promoted reach. Important: This metric stops updating when ad promotions end. Due to API limitations, the sum of organic + promoted Reach may not match the Reach metric once the promotions stop.	Promoted	`AVG_PAID_REACH`
Avg. Shares - Paid	The average number of times your promoted posts were shared. Important: This metric stops updating when ad promotions end.	Promoted	`AVG_PAID_SHARES`
Avg. Video Views - Paid	The estimated average number of times viewers watched your video through promoted reach. Includes replays and multiple views from the same viewer. Important: This metric stops updating when ad promotions end. Due to API limitations, this is an estimated value and the sum of organic + promoted views may not match the Video Views metric once the promotions end.	Promoted	`AVG_PAID_VIDEO_VIEWS`
Avg. Reach - Total	The average Reach of your organic and promoted videos published during the reporting period	Organic + Promoted	`AVG_REACH`
Avg. Retention Rate - Total	The average Retention Rate of the organic and promoted videos published during the reporting period	Organic + Promoted	`AVG_RETENTION_RATE`
Avg. Time Watched - Total	The average amount of time viewers spent watching your organic and promoted videos published during the reporting period	Organic + Promoted	`AVG_TIME_WATCHED`
Avg. Comments - Total	The average number of comments your organic and promoted videos published during the reporting period received	Organic + Promoted	`AVG_TOTAL_COMMENTS`
Avg. Engagements - Total	The average number of engagements your organic and promoted videos published during the reporting period received. Total Engagements = Likes + Comments + Shares	Organic + Promoted	`AVG_TOTAL_ENGAGEMENTS`
Avg. Likes - Total	The average number of likes your organic and promoted videos published during the reporting period received	Organic + Promoted	`AVG_TOTAL_LIKES`
Avg. Shares - Total	The average number of shares your organic and promoted videos published during the reporting period received	Organic + Promoted	`AVG_TOTAL_SHARES`
Avg. Traffic - Following Page - Total	The average percentage of video views coming from the Following Page for videos published during the reporting period	Organic + Promoted	`AVG_TRAFFIC_FROM_FOLLOWING_PAGE`
Avg. Traffic - Hashtag - Total	The average percentage of video views coming from a Hashtag for videos published during the reporting period	Organic + Promoted	`AVG_TRAFFIC_FROM_HASHTAG`
Avg. Traffic - Personal Profile - Total	The average percentage of video views coming from your Personal profile for videos published during the reporting period	Organic + Promoted	`AVG_TRAFFIC_FROM_PERSONAL_PROFILE`
Avg. Traffic - Search - Total	The average percentage of video views coming from Search for videos published during the reporting period	Organic + Promoted	`AVG_TRAFFIC_FROM_SEARCH`
Avg. Traffic - Sound - Total	The average percentage of video views coming from a Sound for videos published during the reporting period	Organic + Promoted	`AVG_TRAFFIC_FROM_SOUND`
Avg. Video Duration - Total	The average duration of your organic and promoted videos published during the reporting period	Organic + Promoted	`AVG_VIDEO_DURATION`
Avg. Video Views - Total	The average number of times your organic and promoted videos published during the reporting period were viewed	Organic + Promoted	`AVG_VIDEO_VIEWS`
Post Sentiment - Negative - Total	The percentage of posts published during the reporting period with an overall negative comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE`
Post Sentiment - Negative - Organic	The percentage of posts with a negative overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEGATIVE_RATE_ORGANIC`
Post Sentiment - Negative - Paid	The percentage of posts with a negative overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE_PROMOTED`
Post Sentiment - Neutral - Total	The percentage of posts published during the reporting period with an overall neutral comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE`
Post Sentiment - Neutral - Organic	The percentage of posts with a neutral overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEUTRAL_RATE_ORGANIC`
Post Sentiment - Neutral - Paid	The percentage of posts with a neutral overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE_PROMOTED`
Post Sentiment - Positive - Total	The percentage of posts published during the reporting period with an overall positive comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE`
Post Sentiment - Positive - Organic	The percentage of posts with a positive overall comment sentiment	Organic	`COMMENT_SENTIMENT_POSITIVE_RATE_ORGANIC`
Post Sentiment - Positive - Paid	The percentage of posts with a positive overall comment sentiment	Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE_PROMOTED`
Engagements - Total - All Posts	The total number of engagements any of your organic and promoted videos received during the reporting period.Total Engagements = Likes + Comments + Shares	Organic + Promoted	`ENGAGEMENTS`
Followers - Growth Rate	The percentage your total followers increased by during the reporting period. Follower Growth Rate = (Current Period - Previous Period) / Previous Period x 100%		`FOLLOWER_GROWTH_RATE`
LikeShop Clicks - All Posts	The number of clicks on your products on your LikeShop feed		`LIKESHOP_CLICKS`
LikeShop Clicks	The number of clicks on your products on your LikeShop feed		`LIKESHOP_CLICKS_BY_POST`
LikeShop Contact Submissions - All Posts	The number of email submissions during the reporting period		`LIKESHOP_CONTACT_SUBMISSIONS`
LikeShop CTR - All Posts	The percentage of times people clicked your product links after viewing your post		`LIKESHOP_CTR`
LikeShop Posts	The number of posts you’ve published during the reporting period that include product links. These are the posts visible on your LikeShop.		`LIKESHOP_POSTS`
LikeShop Views - All Posts	The number of times your posts were displayed on a person’s screen. This includes repeat views.		`LIKESHOP_VIEWS`
Followers - Net New	The net new number of people who have followed your account during the reporting period		`NET_NEW_FOLLOWERS`
Number of Posts - Organic	The number of organic posts you’ve published during the reporting period	Organic	`NUMBER_OF_ORGANIC_POSTS`
Number of Posts - Paid	The number of promoted posts you’ve published during the reporting period	Promoted	`NUMBER_OF_PAID_POSTS`
Number of Posts - Total	The number of posts you’ve published during the reporting period	Organic + Promoted	`NUMBER_OF_POSTS`
Comments - Total - All Posts	The number of comments any of your organic and promoted videos received during the reporting period	Organic + Promoted	`ORGANIC_COMMENTS`
Likes - Total - All Posts	The number of likes any of your organic and promoted videos received during the reporting period	Organic + Promoted	`ORGANIC_LIKES`
Likes - Organic	The number of likes your organic posts received. Important: This metric stops updating when ad promotions end.	Organic	`ORGANIC_LIKES_POSTS`
Shares - Organic	The number of times your organic posts were shared. Important: This metric stops updating when ad promotions end.	Organic	`ORGANIC_SHARES`
Video Views - Est. Organic	The estimated number of times viewers watched your video through organic reach. Includes replays and multiple views from the same viewer. Important: This metric stops updating when ad promotions end. Due to API limitations, this is an estimated value and the sum of organic + promoted views may not match the Video Views metric once the promotions end.	ESTIMATED_ORGANIC	`ORGANIC_VIEWS`
Engagements - Paid	The total number of engagements your promoted posts received. Important: This metric stops updating when ad promotions end.	Promoted	`PAID_ENGAGEMENTS`
Likes - Paid	The number of likes your promoted posts received. Important: This metric stops updating when ad promotions end.	Promoted	`PAID_LIKES`
Shares - Paid	The number of times your promoted posts were shared. Important: This metric stops updating when ad promotions end.	Promoted	`PAID_SHARES`
Video Views - Paid	The estimated number of times viewers watched your video through promoted reach. Includes replays and multiple views from the same viewer. Important: This metric stops updating when ad promotions end. Due to API limitations, this is an estimated value and the sum of organic + promoted views may not match the Video Views metric once the promotions end.	Promoted	`PAID_VIDEO_VIEWS`
Avg. Engagement Rate (Views) - Paid	The percentage of people who engaged with your promoted posts after seeing them. Important: This metric stops updating when ad promotions end.	Promoted	`PAID_VIEWS_BASED_ENGAGEMENT_RATE`
Profile Views	The number of times people viewed your profile		`PROFILE_VIEWS`
Shares - Total - All Posts	The number of times any of your organic and promoted videos were shared during the reporting period	Organic + Promoted	`SHARES`
Comments - Total	The number of comments your organic and promoted videos published during the reporting period received	Organic + Promoted	`TOTAL_COMMENTS`
Engagements - Total	The number of engagements your organic and promoted videos published during the reporting period received Total Engagements = Likes + Comments + Shares	Organic + Promoted	`TOTAL_ENGAGEMENTS`
Favorites - Total	The total number of times your posts have been added to favorites	Organic + Promoted	`TOTAL_FAVORITES`
Followers	The total number of followers you have on this channel		`TOTAL_FOLLOWERS`
Follows - Total	The number of viewers who started following you after viewing your posts	Organic + Promoted	`TOTAL_FOLLOWS`
Likes - Total	The number of likes your organic and promoted videos published during the reporting period received	Organic + Promoted	`TOTAL_LIKES`
Follows - Organic	The number of viewers who started following you after viewing your posts. Important: This metric stops updating when ad promotions end.	Organic	`TOTAL_ORGANIC_FOLLOWS`
Profile Views - Organic	The number of profile views generated by your posts. Important: This metric stops updating when ad promotions end. Data may be delayed by 48 hours.	Organic	`TOTAL_ORGANIC_PROFILE_VIEWS`
Follows - Paid	The number of viewers who started following you after viewing your posts. Important: This metric stops updating when ad promotions end.	Promoted	`TOTAL_PAID_FOLLOWS`
Profile Views - Paid	The number of profile views generated by your posts. Important: This metric stops updating when ad promotions end. Data may be delayed by 48 hours.	Promoted	`TOTAL_PAID_PROFILE_VIEWS`
Profile Views - Total	The total number of profile views generated by your posts. Data may be delayed by 48 hours.	Organic + Promoted	`TOTAL_PROFILE_VIEWS`
Shares - Total	The number of times your posts published during the reporting period were shared	Organic + Promoted	`TOTAL_SHARES`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Video Duration - Total	The length of your published videos	Organic + Promoted	`TOTAL_VIDEO_DURATION`
Video Views - Total	The number of times your organic and promoted videos published during the reporting period were viewed	Organic + Promoted	`TOTAL_VIDEO_VIEWS`
Video Views - Total - All Posts	The number of times any of your organic and promoted videos were viewed during the reporting period	Organic + Promoted	`VIDEO_VIEWS`
Avg. Engagement Rate (Views) - Total	The percentage of people who engaged with your posts after seeing them	Organic + Promoted	`VIEWS_BASED_ENGAGEMENT_RATE`
Total Time Watched - Total	The total amount of time viewers spent watching your videos	Organic + Promoted	`WATCH_TIME`

Metric Name	Description	Post Types	Metric API Name
Avg. Effectiveness - Total	The average percentage of viewers who saw your posts and engaged with them	Organic + Promoted	`AVG_EFFECTIVENESS_V2`
Avg. Engagement Rate - Total	The average percentage of people who engaged with a post after seeing it	Organic + Promoted	`AVG_ENGAGEMENT_RATE_V2`
Avg. Effectiveness - Organic	The average percentage of viewers who saw your posts and engaged with them. Organic Effectiveness is not available for Promoted posts published after June 15, 2026	Organic	`AVG_ORGANIC_EFFECTIVENESS_V2`
Avg. Engagement Rate - Organic	The average percentage of people who engaged with a post after seeing it	Organic	`AVG_ORGANIC_ENGAGEMENT_RATE_V2`
Avg. Viewers - Total	The average number of unique accounts that have viewed your posts at least once. Note: Values before July 31, 2025 reflect Reach, which Meta replaced with Viewers.	Organic + Promoted	`AVG_PAID_AND_ORGANIC_POST_REACH_V2`
Avg. Effectiveness - Paid	The average percentage of viewers who saw your posts and engaged with them	Promoted	`AVG_PAID_EFFECTIVENESS_V2`
Avg. Engagement Rate - Paid	The average percentage of people who engaged with a post after seeing it	Promoted	`AVG_PAID_ENGAGEMENT_RATE_V2`
Avg. Reach - Paid	The average number of unique accounts that have viewed your posts at least once. Note: This metric uses Reach from Ad campaigns.	Promoted	`AVG_PAID_POST_REACH_V2`
Avg. CTR - Paid	The average percentage of times people clicked your posts after seeing them	Promoted	`CLICK_THROUGH_RATE`
Comments - Total - All Posts	The number of comments any of your posts received during the Reporting Period	Organic + Promoted	`COMMENTS_ALL_POSTS`
Post Sentiment - Negative	The percentage of posts published during the Reporting Period with an overall negative comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE`
Post Sentiment - Negative	The percentage of posts with a negative overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEGATIVE_RATE_ORGANIC`
Post Sentiment - Negative	The percentage of posts with a negative overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE_PROMOTED`
Post Sentiment - Neutral	The percentage of posts published during the Reporting Period with an overall neutral comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE`
Post Sentiment - Neutral	The percentage of posts with a neutral overall comment sentiment	Organic	`COMMENT_SENTIMENT_NEUTRAL_RATE_ORGANIC`
Post Sentiment - Neutral	The percentage of posts with a neutral overall comment sentiment	Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE_PROMOTED`
Post Sentiment - Positive	The percentage of posts published during the Reporting Period with an overall positive comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE`
Post Sentiment - Positive	The percentage of posts with a positive overall comment sentiment	Organic	`COMMENT_SENTIMENT_POSITIVE_RATE_ORGANIC`
Post Sentiment - Positive	The percentage of posts with a positive overall comment sentiment	Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE_PROMOTED`
Avg. CPC - Paid	The average cost per click on your posts	Promoted	`COST_PER_CLICK`
Avg. CPM - Paid	The average cost per 1,000 impressions on your posts	Promoted	`COST_PER_MILE`
Followers - Growth Rate	The percentage your Page’s Followers increased by during the Reporting Period. Followers Growth Rate = (New Followers - Old Followers) / Old Followers x 100%		`FOLLOWER_GROWTH_RATE`
Link Clicks - Total	The number of times people clicked on the link in a post or link preview for posts published during the Reporting Period	Organic + Promoted	`LINK_CLICKS`
Followers - Net New	The net new number of Followers your page has gained		`NET_NEW_FOLLOWERS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic + Promoted	`NUMBER_OF_POSTS`
Number of Posts	The number of posts you’ve published during the reporting period	Promoted	`NUMBER_OF_POSTS_PAID`
Comments - Organic	The number of comments received on posts published during the reporting period	Organic	`ORGANIC_COMMENTS`
Engagements - Organic	The total number of engagements your posts received	Organic	`ORGANIC_ENGAGEMENTS_POSTS_V2`
Number of Posts	The number of posts you’ve published during the reporting period	Organic	`ORGANIC_NUMBER_OF_POSTS`
Reactions - Organic	The total number of reactions your posts published during the reporting period received	Organic	`ORGANIC_REACTIONS`
Shares - Organic	The number of times your posts published during the reporting period were shared	Organic	`ORGANIC_SHARES`
Video Views - Organic	The number of times your videos were viewed	Organic	`ORGANIC_VIDEO_VIEWS`
Views - Organic	The number of times your posts were viewed	Organic	`ORGANIC_VIEWS_BY_POST`
Other Clicks - Total	The number of clicks on your posts, including links and other clickable elements on posts published during the reporting period	Organic + Promoted	`OTHER_CLICKS`
Views - Organic - All Posts	The number of times your posts were viewed or displayed during the reporting period	Organic	`PAGE_VIEWS_ORGANIC`
Views - Paid - All Posts	The number of times your posts were viewed or displayed during the reporting period	Promoted	`PAGE_VIEWS_PAID`
Views - Total - All Posts	The number of times your posts were viewed or displayed during the reporting period	Organic + Promoted	`PAGE_VIEWS_PAID_AND_ORGANIC`
Video Complete Views - Total	The number of times your video was played from the beginning to 95% or more of its length	Organic + Promoted	`PAID_AND_ORGANIC_VIDEO_COMPLETE_VIEWS`
Video Views - Total	The number of times your videos were viewed	Organic + Promoted	`PAID_AND_ORGANIC_VIDEO_VIEWS`
Views - Total	The number of times your posts were viewed	Organic + Promoted	`PAID_AND_ORGANIC_VIEWS_BY_POST`
Comments - Paid	The number of comments your posts received	Promoted	`PAID_COMMENTS`
Avg. Cost Per Thruplay - Paid	The average cost per Thruplay for your videos	Promoted	`PAID_COST_PER_THRUPLAY`
Engagements - Paid	The total number of engagements your posts received	Promoted	`PAID_ENGAGEMENTS_POSTS`
Avg. Frequency - Paid	The average number of times people saw your promoted posts	Promoted	`PAID_FREQUENCY`
Reactions - Paid	The number of reactions your posts received. Reactions include Like, Love, Care, Haha, Wow, Sad and Angry.	Promoted	`PAID_REACTIONS`
Shares - Paid	The number of times your posts were shared	Promoted	`PAID_SHARES`
ThruPlays - Paid	The number of times your posts were watched to completion or for at least 15 seconds	Promoted	`PAID_THRUPLAYS`
Video Complete Views - Paid	The number of times your videos were played from the beginning to 95%, or more, of their length	Promoted	`PAID_VIDEO_COMPLETE_VIEWS`
Video Plays 25% - Paid	The number of times your video was played to 25% of its length, including plays that skipped to this point	Promoted	`PAID_VIDEO_PLAYS_25`
Video Plays 50% - Paid	The number of times your video was played to 50% of its length, including plays that skipped to this point	Promoted	`PAID_VIDEO_PLAYS_50`
Video Plays 75% - Paid	The number of times your video was played to 75% of its length, including plays that skipped to this point	Promoted	`PAID_VIDEO_PLAYS_75`
Video Views - Paid	The number of times your videos were viewed	Promoted	`PAID_VIDEO_VIEWS`
Views - Paid	The number of times your posts were viewed	Promoted	`PAID_VIEWS_BY_POST`
Photo View Clicks - Total	The number of times users clicked on your photos published during the reporting period	Organic + Promoted	`PHOTO_VIEW_CLICKS`
Post Clicks - Total	The number of times a user clicked anywhere on your posts published during the reporting period	Organic + Promoted	`POST_CLICKS`
Reactions - Total	The number of times people clicked on like, care, love, wow, haha, sad, and anger reactions on posts published during the Reporting Period	Organic + Promoted	`REACTIONS`
Reactions - Total - All Posts	The number of reactions your posts received. Reactions include Like, Love, Care, Haha, Wow, Sad and Angry.	Organic + Promoted	`REACTIONS_ALL_POSTS`
Plays - Total	The number of times your videos published during the Reporting Period were initially played. This excludes replays	Organic + Promoted	`REELS_BLUE_REELS_PLAYS_COUNT`
Replays - Total	The number of rewatches your videos published during the Reporting Period received in the same session	Organic + Promoted	`REELS_FB_REELS_REPLAY_COUNT`
Avg. Time Watched - Total	The average time your videos published during the Reporting Period were played during a single viewing	Organic + Promoted	`REELS_POST_VIDEO_AVG_TIME_WATCHED`
Follows - Total	The number of viewers who followed your Page after viewing your videos published during the Reporting Period	Organic + Promoted	`REELS_POST_VIDEO_FOLLOWERS`
Total Time Watched - Total	The sum of time that viewers watched your videos published during the Reporting Period	Organic + Promoted	`REELS_POST_VIDEO_VIEW_TIME`
Reactions - Angry - Total	The number of times people used an Angry reaction to your post	Organic + Promoted	`REEL_REACTION_ANGRY`
Reactions - Haha - Total	The number of times people used a Haha reaction to your post	Organic + Promoted	`REEL_REACTION_HAHA`
Reactions - Like - Total	The number of times people used a Like or a Care reaction to your post	Organic + Promoted	`REEL_REACTION_LIKE`
Reactions - Love - Total	The number of times people used a Love reaction to your post	Organic + Promoted	`REEL_REACTION_LOVE`
Reactions - Sad - Total	The number of times people used a Sad reaction to your post	Organic + Promoted	`REEL_REACTION_SAD`
Reactions - Wow - Total	The number of times people used a Wow reaction to your post	Organic + Promoted	`REEL_REACTION_WOW`
Shares - Total	The number of times your posts were shared	Organic + Promoted	`SHARES`
Comments - Total	The number of comments your posts received	Organic + Promoted	`TOTAL_COMMENTS`
Engagements - Total - All Posts	The total number of reactions, comments, shares, and post clicks on all posts during the Reporting Period	Organic + Promoted	`TOTAL_ENGAGEMENTS`
Engagements - Total	The total number of engagements your posts received	Organic + Promoted	`TOTAL_ENGAGEMENTS_POSTS_V2`
Followers	The total number of Followers your Facebook Page has		`TOTAL_FOLLOWERS`
Amount Spent - Paid	The total amount of money you’ve spent boosting your posts. Due to API delays, recent spend figures may be estimated for up to 48 hours.	Promoted	`TOTAL_SPENT`
Total Social Impact	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Video Complete Views - Organic	The number of times your videos published during the Reporting Period were played from the beginning to 95%, or more, of its length	Organic	`VIDEO_COMPLETE_VIEWS`
Viewers - All Posts	The number of unique accounts that viewed any content on your Page. Content includes reels, posts, stories, live videos and ads.		`VIEWERS`

Metric Name	Description	Post Types	Metric API Name
Avg. Card Click Rate - Total	The average cards click-through-rate on your organic and promoted videos published during the Reporting Period. Card Click Rate = Card Clicks / Card Impressions	Organic + Promoted	`AVG_CARD_CLICK_RATE`
Avg. Card Teaser Click Rate - Total	The average card teasers click-through-rate on your organic and promoted videos published during the Reporting Period. Card Teaser Click Rate = Card Teaser Clicks / Card Teaser Impressions	Organic + Promoted	`AVG_CARD_TEASER_CLICK_RATE`
Avg. View Duration - Total - All Posts	The average amount of time viewers spent watching any of your organic and promoted videos during the Reporting Period	Organic + Promoted	`AVG_VIEW_DURATION`
Avg. Percentage Viewed - Total - All Posts	The average retention rate of your organic and promoted videos during the Reporting Period	Organic + Promoted	`AVG_VIEW_PERCENTAGE`
Card Clicks - Total - All Posts	The number of times the cards were clicked on all your organic and promoted videos during the Reporting Period	Organic + Promoted	`CARD_CLICKS`
Avg. Card Click Rate - Total - All Posts	The average cards click-through-rate on all your organic and promoted videos during the Reporting Period. Card Click Rate = Card Clicks / Card Impressions	Organic + Promoted	`CARD_CLICK_RATE`
Card Impressions - Total - All Posts	The number of times cards were displayed on all your organic and promoted videos during the Reporting Period	Organic + Promoted	`CARD_IMPRESSIONS`
Card Teaser Clicks - Total - All Posts	The number of times the card teasers were clicked on all your organic and promoted videos during the Reporting Period	Organic + Promoted	`CARD_TEASER_CLICKS`
Avg. Card Teaser Click Rate - Total - All Posts	The average card teasers click-through-rate on all your organic and promoted videos during the Reporting Period. Card Teaser Click Rate = Card Teaser Clicks / Card Teaser Impressions	Organic + Promoted	`CARD_TEASER_CLICK_RATE`
Card Teaser Impressions - Total - All Posts	The number of times card teasers were displayed on all your organic and promoted videos during the Reporting Period	Organic + Promoted	`CARD_TEASER_IMPRESSIONS`
Comments - Total - All Posts	The number of comments any of your organic and promoted videos received during the Reporting Period	Organic + Promoted	`COMMENTS`
Post Sentiment - Negative	The percentage of posts published during the Reporting Period with an overall negative comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEGATIVE_RATE`
Post Sentiment - Neutral	The percentage of posts published during the Reporting Period with an overall neutral comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_NEUTRAL_RATE`
Post Sentiment - Positive	The percentage of posts published during the Reporting Period with an overall positive comment sentiment	Organic + Promoted	`COMMENT_SENTIMENT_POSITIVE_RATE`
Dislikes - Total - All Posts	The number of dislikes any of your organic and promoted videos received during the Reporting Period	Organic + Promoted	`DISLIKES`
Engagements - Total - All Posts	The total number of engagements any of your organic and promoted videos received during the Reporting Period. Total Engagements = Likes + Dislikes + Comments + Shares	Organic + Promoted	`ENGAGEMENTS`
Premium Watch Time - Total - All Posts	The total amount of time your organic and promoted videos were viewed during the Reporting Period by YouTube Premium members	Organic + Promoted	`ESTIMATED_PREMIUM_SECONDS_WATCHED`
Watch Time - Total - All Posts	The total amount of time that viewers watched any organic and promoted videos on your channel during the Reporting Period	Organic + Promoted	`ESTIMATED_SECONDS_WATCHED`
Likes - Total - All Posts	The number of likes any of your organic and promoted videos received during the Reporting Period	Organic + Promoted	`LIKES`
Number of Posts	The number of posts you’ve published during the reporting period	Organic + Promoted	`NUMBER_OF_POSTS`
Premium Views - Total - All Posts	The number of times your organic and promoted videos were viewed during the Reporting Period by YouTube Premium members	Organic + Promoted	`PREMIUM_VIEWS`
Shares - Total - All Posts	The number of shares any of your organic and promoted videos received during the Reporting Period	Organic + Promoted	`SHARES`
Subscribers - Lost	The total number of people who unsubscribed from your channel		`SUBSCRIBERS_LOST`
Subscribers - Net New	The net new number of users who have subscribed to your channel during the Reporting Period		`SUBSCRIBERS_NET_NEW`
Subscribers	The number of users who have subscribed to your channels by the last day of the Reporting Period		`SUBSCRIBERS_TOTAL`
Subscribers - Growth Rate	The percentage your subscribers have increased by during the Reporting Period. Subscriber Growth Rate = (Current Period - Previous Period) / Previous Period x 100%		`SUBSCRIBER_GROWTH_RATE`
Avg. View Duration - Total	The average amount of time viewers spent watching your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_AVG_VIEW_DURATION`
Avg. Percentage Viewed - Total	The average retention rate of your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_AVG_VIEW_PERCENTAGE`
Card Clicks - Total	The number of times the cards were clicked on your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_CARD_CLICKS`
Card Impressions - Total	The number of times cards were displayed on your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_CARD_IMPRESSIONS`
Card Teaser Clicks - Total	The number of times the card teasers were clicked on your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_CARD_TEASER_CLICKS`
Card Teaser Impressions - Total	The number of times card teasers were displayed on your organic and promoted videos published during the Reporting Period	Organic + Promoted	`TOTAL_CARD_TEASER_IMPRESSIONS`
Comments - Total	The total number of comments your organic and promoted videos published during the Reporting Period received	Organic + Promoted	`TOTAL_COMMENTS`
Dislikes - Total	The total number of dislikes your organic and promoted videos published during the Reporting Period received	Organic + Promoted	`TOTAL_DISLIKES`
Engagements - Total	The total number of engagements your organic and promoted videos published during the Reporting Period received. Total Engagements = Likes + Dislikes + Comments + Shares	Organic + Promoted	`TOTAL_ENGAGEMENTS`
Watch Time - Total	The total amount of time that viewers watched organic and promoted videos on your channel that were published during the Reporting Period	Organic + Promoted	`TOTAL_ESTIMATED_SECONDS_WATCHED`
Premium Watch Time - Total	The total amount of time your organic and promoted videos published during the Reporting Period were viewed by YouTube Premium members	Organic + Promoted	`TOTAL_EST_PREMIUM_SECONDS_WATCHED`
Likes - Total	The total number of likes your organic and promoted videos published during the Reporting Period received	Organic + Promoted	`TOTAL_LIKES`
Premium Views - Total	The number of times your organic and promoted videos published during the Reporting Period were viewed by YouTube Premium members	Organic + Promoted	`TOTAL_PREMIUM_VIEWS`
Shares - Total	The total number of shares your organic and promoted videos published during the Reporting Period received	Organic + Promoted	`TOTAL_SHARES`
Subscribers - Gained	The number of viewers who subscribed while watching your videos	Organic + Promoted	`TOTAL_SUBSCRIBERS_GAINED`
Subscribers - Lost	The number of viewers who unsubscribed while watching your videos	Organic + Promoted	`TOTAL_SUBSCRIBERS_LOST`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Added to Playlist - Total	The total number of times your organic and promoted videos published during the Reporting Period were added to a playlist	Organic + Promoted	`TOTAL_VIDEOS_ADDED_TO_PLAYLIST`
Video Views - Total	The total number of times your organic and promoted videos published during the Reporting Period were viewed	Organic + Promoted	`TOTAL_VIDEO_VIEWS`
Added to Playlist - Total - All Posts	The number of times any of your organic and promoted videos were added to any YouTube playlists during the Reporting Period	Organic + Promoted	`VIDEOS_ADDED_TO_PLAYLIST`
Video Views - Total - All Posts	The number of times your organic and promoted videos were viewed during the Reporting Period	Organic + Promoted	`VIEWS`

Metric Name	Description	Post Types	Metric API Name
Engagement Rate - All Posts	The average percentage of your audience that engaged with your Pins during the Reporting Period. Engagement Rate = (Pin Clicks + Outbound Clicks + Saves) / Impressions.	Organic	`AVG_ENGAGEMENT_RATE`
Avg. Watch Time	The average time spent watching your video Pins	Organic	`AVG_WATCH_TIME`
Pin Clicks - All Posts	The number of times your Pins were clicked to view more details during the Reporting Period	Organic	`CLOSEUPS`
Engagements	The total number of engagements your Pins received	Organic	`ENGAGEMENTS`
Followers - Growth Rate	The percentage your followers increased by over the comparison period		`FOLLOWER_GROWTH_RATE`
Impressions - All Posts	The number of times your Pins were viewed or displayed	Organic	`IMPRESSIONS`
Outbound Clicks - All Posts	The number of times the links in your Pins were clicked during the Reporting Period	Organic	`LINK_CLICKS`
Followers - Net New	The net new number of people who have followed your account		`NET_NEW_FOLLOWERS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic	`NUMBER_OF_POSTS`
Saves - All Posts	The number of times users saved your Pins during the reporting period	Organic	`SAVES`
Avg. Engagement Rate	The average percentage of your audience that engaged with your Pins published during the reporting period. Engagement Rate = (Pin Clicks + Outbound Clicks + Saves) / Impressions.	Organic	`TOTAL_AVG_ENGAGEMENT_RATE`
Engagements - All Posts	The total number of organic engagements your images, videos, and product pins received during the reporting period	Organic	`TOTAL_ENGAGEMENTS`
Followers	The total number of followers you have on this channel		`TOTAL_FOLLOWERS`
Impressions	The number of impressions received on posts published during the reporting period	Organic	`TOTAL_IMPRESSIONS`
Outbound Clicks	The number of clicks on the links in your Pins published during the reporting period	Organic	`TOTAL_LINK_CLICKS`
Saves	The number of times your Pins published during the reporting period were saved by a user	Organic	`TOTAL_SAVES`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Video Views	The number of views lasting at least two seconds with 50% of the video pin visible from post published during the reporting period	Organic	`TOTAL_VIDEO_VIEWS`

Metric Name	Description	Post Types	Metric API Name
Engagement Rate - All Posts	The average engagement rate of your tweets during the reporting period. Engagement Rate = Total Engagements / Impressions	Organic	`AVG_ENGAGEMENT_RATE`
Link Clicks	The number of times links on your posts were clicked	Organic	`CLICKS_BY_POST`
Post Sentiment - Negative	The percentage of posts published during the reporting period with an overall negative comment sentiment	Organic	`COMMENT_SENTIMENT_NEGATIVE_RATE`
Post Sentiment - Neutral	The percentage of posts published during the reporting period with an overall neutral comment sentiment	Organic	`COMMENT_SENTIMENT_NEUTRAL_RATE`
Post Sentiment - Positive	The percentage of posts published during the reporting period with an overall positive comment sentiment	Organic	`COMMENT_SENTIMENT_POSITIVE_RATE`
Followers - Growth Rate	The percentage your followers increased by during the reporting period. Follower Growth Rate = (New Followers - Old Followers) / Old Followers x 100%		`FOLLOWER_GROWTH_RATE`
Impressions - All Posts	The number of times your posts were viewed or displayed	Organic	`IMPRESSIONS`
Impressions	The number of times your posts published during the reporting period were displayed	Organic	`IMPRESSIONS_BY_POST`
Likes - All Posts	The number of likes your Tweets received during the reporting period	Organic	`LIKES`
Link Clicks - All Posts	The number of times links on your Tweets were clicked during the reporting period	Organic	`LINK_CLICKS`
Followers - Net New	The net new number of people who have followed your account		`NET_NEW_FOLLOWERS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic	`NUMBER_OF_POSTS`
Video Views - All Posts	The number of times your videos were viewed	Organic	`ORGANIC_VIDEO_VIEWS`
Profile Clicks - All Posts	The number of times your profile has been clicked from Tweets during the reporting period	Organic	`PROFILE_CLICKS`
Quote Posts - All Posts	The number of times your Tweets were Quote Tweeted during the reporting period	Organic	`QUOTE_TWEETS`
Replies - All Posts	The number of replies your Tweets received during the reporting period	Organic	`REPLIES`
Replies	The number of replies your posts received	Organic	`REPLIES_BY_POST`
Reposts - All Posts	The number of times your Tweets were Retweeted during the reporting period	Organic	`RETWEETS`
Reposts	The number of times your posts were reposted	Organic	`RETWEETS_BY_POST`
Avg. Engagement Rate	The average engagement rate of your tweets published during the reporting period. Engagement Rate = Total Engagements / Impressions	Organic	`TOTAL_AVG_ENGAGEMENT_RATE`
Engagements - All Posts	The total number of times a user interacted with your tweets during the reporting period, including Retweets, replies, likes, hashtags, or link clicks	Organic	`TOTAL_ENGAGEMENTS`
Engagements	The total number of engagements your posts published during the reporting period received Engagements = Likes + Dislikes + Comments + Shares	Organic	`TOTAL_ENGAGEMENTS_POSTS`
Followers	The total number of followers you have on this channel		`TOTAL_FOLLOWERS`
Likes	The number of likes your posts received	Organic	`TOTAL_LIKES`
Total Reposts - All Posts	The total number of times your Tweets were Retweeted during the reporting period. Total Retweets = Retweets + Quote Tweets	Organic	`TOTAL_RETWEETS`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Video Views	The number of times your videos were viewed	Organic + Promoted	`TOTAL_VIDEO_VIEWS`

Metric Name	Description	Post Types	Metric API Name
Avg. CTR	The average percentage of your audience that clicked on posts published during the reporting period. Click Through Rate = Clicks / Impressions	Organic	`AVG_CLICK_THROUGH_RATE_BY_POST`
Avg. Engagements	The total number of engagements your posts received	Organic	`AVG_ENGAGEMENTS_BY_POST`
Avg. Engagement Rate - All Posts	The average engagement rate of all your posts during the reporting period. Engagement Rate = (Clicks + Reactions + Comments + Reposts) / Impressions	Organic	`AVG_ENGAGEMENT_RATE_ALL_POSTS`
Avg. Engagement Rate	The average engagement rate of your posts that were published during the Reporting Period. Engagement Rate = (Clicks + Reactions + Comments + Reposts) / Impressions	Organic	`AVG_ENGAGEMENT_RATE_BY_POST`
Avg. Unique Impressions	The average number of unique LinkedIn members that saw your posts published during the reporting period. Similar to Reach	Organic	`AVG_UNIQUE_IMPRESSIONS_BY_POST`
Avg. Video Views	The number of times your videos were viewed	Organic	`AVG_VIDEO_VIEWS_BY_POST`
Clicks - All Posts	The number of times people clicked on any of your posts during the reporting period	Organic	`CLICKS_ALL_POSTS`
Clicks	The number of times people clicked on your posts published during the reporting period	Organic	`CLICKS_BY_POST`
Avg. CTR - All Posts	The average percentage of your audience that clicked on your posts during the Reporting Period. Click Through Rate = Clicks / Impressions	Organic	`CLICK_THROUGH_RATE`
Comments - All Posts	The number of comments any of your posts received during the reporting period	Organic	`COMMENTS_ALL_POSTS`
Comments	The number of comments received on posts published during the reporting period	Organic	`COMMENTS_BY_POST`
Engagements - All Posts	The total number of engagements your posts received	Organic	`ENGAGEMENTS`
Engagements	The total number of engagements on your posts published during the reporting period Engagements = Clicks + Reactions + Comments + Reposts	Organic	`ENGAGEMENTS_BY_POST`
Followers - Growth Rate	The percentage your total followers increased by during the reporting period. Follower Growth Rate = (Current Period - Previous Period) / Previous Period x 100%		`FOLLOWER_GROWTH_RATE`
Impressions - All Posts	The number of times your posts have been viewed during the reporting period	Organic	`IMPRESSIONS_ALL_POSTS`
Impressions	The number of times your posts published during the reporting period have been viewed	Organic	`IMPRESSIONS_BY_POST`
Followers - Net New	The net new number of LinkedIn members who have followed your Page during the Reporting Period		`NET_NEW_FOLLOWERS`
Number of Posts	The number of posts you’ve published during the reporting period	Organic	`NUMBER_OF_POSTS`
Page Views - All Posts	The number of times your Page was viewed during the reporting period		`PAGE_VIEWS_ALL_POSTS`
Reactions - All Posts	The number of reactions any of your posts received during the reporting period	Organic	`REACTIONS_ALL_POSTS`
Reactions	The total number of reactions on your posts published during the reporting period	Organic	`REACTIONS_BY_POST`
Shares - All Posts	The number of times any of your posts were shared during the reporting period	Organic	`SHARES_ALL_POSTS`
Shares	The number of times your posts published during the reporting period were shared	Organic	`SHARES_BY_POST`
Followers	The total number of followers you have on this channel		`TOTAL_FOLLOWERS`
Total Social Impact - All Posts	TSI is like a market index for your brand’s social presence - it brings together everything your brand does across social to reveal the strength of your total presence. It rolls up all your channels, content, and engagement into one score that grows over time, giving you a clear view of performance and momentum.		`TOTAL_TSI`
Unique Impressions	The number of times any of your posts were shown to unique LinkedIn members. Similar to Reach	Organic	`UNIQUE_IMPRESSIONS_ALL_POSTS`
Unique Visitors - All Posts	The number of unique LinkedIn members who visited your Page during the reporting period	Organic	`UNIQUE_VISITORS_ALL_POSTS`
Video Views	The number of times your videos published during the reporting period were viewed	Organic	`VIDEO_VIEWS_BY_POST`
Watch Time	The total amount of time viewers spent watching your videos published during the Reporting Period	Organic	`WATCH_TIME_BY_POST`

Next steps

You now have a JSON response with total performance metrics per brand and platform. Use this data to:

Power BI dashboards - Feed weekly or quarterly totals into Looker, Tableau, or other BI tools
Compare performance - Analyze growth between brands or channels
Executive reporting - Summarize KPIs for leadership

Related guides:

Get Started

Reporting

Campaigns

Scheduler

Social Commerce

Social Listening

Community

Integration

MCP Server

Pull total social metrics across channels

Use cases

Executive Dashboard

Quarterly Review

Cross-Channel Analysis

Before you start

Implementation

Step 1: Map your parameters

Step 2: Make the API call

Key query parameters

Multiple metrics

Sample response

Querying multiple brands and channels

Metrics

Next steps

​Use cases

Executive Dashboard

Quarterly Review

Cross-Channel Analysis

​Before you start

​Implementation

​Step 1: Map your parameters

​Step 2: Make the API call

​Key query parameters

​Multiple metrics

​Sample response

​Querying multiple brands and channels

​Metrics

​Next steps

Use cases

Before you start

Implementation

Step 1: Map your parameters

Step 2: Make the API call

Key query parameters

Multiple metrics

Sample response

Querying multiple brands and channels

Metrics

Next steps