Pull time-series data with graph report

Track how your social metrics change over time. This guide shows you how to pull daily or monthly time-series data using the Graph report. Use this data to chart trends in Power BI, Tableau, or Looker.

Use cases

Static snapshots miss the story. The Graph report breaks metrics down by date so you can track momentum and spot patterns over time.

Spot content patterns

Chart daily Instagram Reels views to identify which days drive the most engagement

Compare brand performance

Plot monthly impressions across brands to see which campaigns gained traction

Measure campaign momentum

Track TikTok engagement trends over 90 days to quantify campaign impact

Before you start

Make sure you have:

API Key - Your authentication token
Brand ID - The ID for the brand you want to report on

If you need help getting these, check out our API Quickstart.

Test in the dashboard first

Build a Graph report in the Dash Social Dashboard UI to preview channel, brand, and metric combinations before using the API.

Implementation

Step 1: Map your parameters

Understand what parameters are available to control your time-series data.

Parameter	Description
`brand_ids`	Your brand ID. Use comma-separated values for multiple brands (e.g., `144,256`).
`channels`	Social platform to report on. Options: `INSTAGRAM` - Feed posts `INSTAGRAM_STORIES` - Stories `FACEBOOK` - Facebook posts `TIKTOK` - TikTok videos `TWITTER` - X posts `YOUTUBE` - YouTube videos `PINTEREST` - Pinterest pins `LINKEDIN` - LinkedIn posts
`metrics`	Time-series metrics to track. See the Metrics section below for all available options.Track multiple metrics by separating with commas (e.g., `VIEWS,REACH,TOTAL_ENGAGEMENTS`).
`report_type`	Set to `GRAPH` to return time-series values grouped by date rather than aggregated totals.
`time_scale`	Time granularity for your data: `DAILY` (default) - Breakdown by day `MONTHLY` - Breakdown by month
`start_date` / `end_date`	Your reporting period in `YYYY-MM-DD` format.
`context_start_date` / `context_end_date`	Optional comparison period for trend analysis in `YYYY-MM-DD` format. Compare current performance against a previous time range.

Time-series data structure: The Graph report returns values grouped by date. Each date in your range has its own metric value for plotting trends over time.

Step 2: Make the API call

Send a GET request to /reports/data using the parameters from Step 1. Set report_type=GRAPH to get time-series data broken down by date instead of aggregated totals.

GET https://dashboard.dashsocial.com/reports/data?channels=INSTAGRAM&brand_ids=144&start_date=2025-05-01&end_date=2025-05-07&metrics=VIEWS&report_type=GRAPH&time_scale=DAILY

This example pulls daily Instagram views for 7 days. Swap in different parameters from Step 1 to customize your analysis.

Step 3: Read the response

The API returns time-series data organized by brand, channel, metric, and date. Sample response:

{
    "data": {
        "144": {
            "avatar": "https://cdn.dashhudson.com/avatars/2306810931.jpeg",
            "data_type": "BRAND",
            "name": "sunny.today",
            "permissions": {
                "brand": {
                    "can_access_metric": true
                },
                "user": {
                    "can_access_brand": true
                }
            },
            "user_has_access": true
        },
        "metrics": {
            "VIEWS": {
                "ALL_CHANNELS": {
                    "2025-05-01": 205.0,
                    "2025-05-02": null,
                    "2025-05-03": null,
                    "2025-05-04": 13.0,
                    "2025-05-05": 11.0,
                    "2025-05-06": 11.0,
                    "2025-05-07": 51.0
                }
            }
        }
    },
    "product_category": "OWNED"
}

Response structure:

data: Nested structure organized by brand → channel → metric → date
Brand ID (e.g., 144): Your brand ID
Channel (e.g., INSTAGRAM): The social platform
Metric (e.g., VIEWS): The performance metric
Date (e.g., 2025-05-01): Each date in your range
Value (e.g., 205.0): The metric value for that date

In this example, Instagram views ranged from 130 to 210 during May 1-7, 2025. Peak performance occurred on May 6.

Want aggregated totals instead? Use the Metric report to get summed KPIs without time breakdowns.

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,4688
  &start_date=2026-05-01
  &end_date=2026-05-07
  &metrics=TOTAL_ENGAGEMENTS,TOTAL_FOLLOWERS
  &report_type=GRAPH
  &aggregate_by=BRAND
  &secondary_aggregate_by=CHANNEL

The response nests channel data under a breakdowns key inside each brand, with time-series values for each date:

{
    "data": {
        "144": {
            "avatar": "https://cdn.dashhudson.com/avatars/2306810931.jpeg",
            "breakdowns": {
                "FACEBOOK": {
                    "data_type": "CHANNEL",
                    "metrics": {
                        "TOTAL_ENGAGEMENTS": {
                            "FACEBOOK": {
                                "2026-05-01": null,
                                "2026-05-02": null,
                                "2026-05-03": null,
                                "2026-05-04": 2.0,
                                "2026-05-05": 0,
                                "2026-05-06": 1.0,
                                "2026-05-07": 0
                            }
                        },
                        "TOTAL_FOLLOWERS": {
                            "FACEBOOK": {
                                "2026-05-01": 150.0,
                                "2026-05-02": 150.0,
                                "2026-05-03": 150.0,
                                "2026-05-04": 150.0,
                                "2026-05-05": 152.0,
                                "2026-05-06": 152.0,
                                "2026-05-07": 152.0
                            }
                        }
                    }
                },
                "INSTAGRAM": {
                    "data_type": "CHANNEL",
                    "metrics": {
                        "TOTAL_ENGAGEMENTS": {
                            "INSTAGRAM": {
                                "2026-05-01": 1.0,
                                "2026-05-02": null,
                                "2026-05-03": 2.0,
                                "2026-05-04": null,
                                "2026-05-05": 1.0,
                                "2026-05-06": null,
                                "2026-05-07": null
                            }
                        },
                        "TOTAL_FOLLOWERS": {
                            "INSTAGRAM": {
                                "2026-05-01": 230.0,
                                "2026-05-02": 230.0,
                                "2026-05-03": 229.0,
                                "2026-05-04": 229.0,
                                "2026-05-05": 229.0,
                                "2026-05-06": 229.0,
                                "2026-05-07": 229.0
                            }
                        }
                    }
                }
            },
            "data_type": "BRAND",
            "name": "sunny.today",
            "permissions": {
                "brand": {
                    "can_access_metric": true
                },
                "user": {
                    "can_access_brand": true
                }
            },
            "user_has_access": true
        },
        "metrics": {
            "TOTAL_ENGAGEMENTS": {
                "ALL_CHANNELS": {
                    "2026-05-01": 1.0,
                    "2026-05-02": null,
                    "2026-05-03": 2.0,
                    "2026-05-04": 2.0,
                    "2026-05-05": 1.0,
                    "2026-05-06": 1.0,
                    "2026-05-07": 0
                }
            }
        }
    },
    "product_category": "OWNED"
}

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

Metrics

Some metrics require a connected Ads account.If a request returns no_ad_account_matching_report_channels, one or more of the requested metrics depends on Ads data that the brand has not connected.On Facebook and TikTok, metrics labelled “Organic only” or “Promoted only” require a connected Ads account. Combined “Total (Organic + Promoted)” metrics and account-level metrics do not. On Instagram, metrics representing “Total (Organic + Promoted)” performance require a connected Meta Ads account.

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`
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`
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`
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
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`
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`
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`
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`

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. 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 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
Engagement Rate - All Posts	The average engagement rate of your tweets during the reporting period. Engagement Rate = Total Engagements / Impressions	Organic	`AVG_ENGAGEMENT_RATE`
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`
Reposts - All Posts	The number of times your Tweets were Retweeted during the reporting period	Organic	`RETWEETS`
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`
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. 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`
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
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. 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`
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

With your time-series data, you can:

Build trend dashboards - Import data into Power BI, Tableau, or Looker to visualize performance over time
Spot patterns - See which days or months drive the most engagement to inform your posting strategy
Compare time periods - Use context_start_date and context_end_date to benchmark performance against past results
Track multiple metrics - Request several metrics in one call to see relationships between reach, views, and engagement

Related guides:

Get Top-Performing Posts with Content Report → - Surface your best content by metric
Aggregate Cross-Channel Metrics → - Get totals instead of time breakdowns
View the Full API Reference →

Get Started

Reporting

Campaigns

Scheduler

Social Commerce

Social Listening

Community

Integration

MCP Server

Pull time-series data with graph report

Use cases

Spot content patterns

Compare brand performance

Measure campaign momentum

Before you start

Test in the dashboard first

Implementation

Step 1: Map your parameters

Step 2: Make the API call

Step 3: Read the response

Querying multiple brands and channels

Metrics

Next steps

​Use cases

Spot content patterns

Compare brand performance

Measure campaign momentum

​Before you start

​Test in the dashboard first

​Implementation

​Step 1: Map your parameters

​Step 2: Make the API call

​Step 3: Read the response

​Querying multiple brands and channels

​Metrics

​Next steps

Use cases

Before you start

Test in the dashboard first

Implementation

Step 1: Map your parameters

Step 2: Make the API call

Step 3: Read the response

Querying multiple brands and channels

Metrics

Next steps