Skip to main content

​
Analytics Refresh & Rate Limits

​
Force Refresh

You can request analytics to be refreshed immediately by calling the analytics endpoint with a force parameter. However, force refresh requests are rate limited to amout of teams * 5 to prevent excessive API calls to social platforms. You may ask why? To protect US from our greatest and brightest vibe code engineers doing: 
while (true) {
  await bundlesocial.analytics.analyticsForceRefresh({
    teamId: team.id,
  });
}
we had such cases…
Rate Limit Formula: Maximum force refresh requests = number of teams × 5For example, if you have 10 teams, you can make up to 50 force refresh requests.

​
Custom Refresh Periods

By default, analytics are automatically refreshed every 24 hours. However, we can configure custom refresh periods based on your organization’s needs. Important: If you require a higher refresh rate (e.g., every 15 minutes for large organizations), there may be additional charges due to increased data costs. We will discuss these costs with you directly to determine the best solution for your use case. Nothing expensive/outlandish etc…, we are not evil. Maybe you will need to skip on OF subscription but you know, economy…

​
Data Retention

We retain analytics data for 40 days from the date of creation. If your team needs yearly or long-term history, we recommend fetching and storing the data daily on your end. This retention period is fixed and will not be extended. Maybe we are evil?

​
Important Note: Data Differences

Data shown in our platform may differ from what you see on the social media platform itself. This can happen for several reasons:
  • Processing Delays: Platforms may take time to process and return analytics data. For example, TikTok can take up to 48 hours for some detailed analytics like audience demographics and splits.
  • Rolling Window Timing: When platforms return rolling window data, the exact time window and aggregation method may differ slightly from what’s displayed in their native interfaces.
  • Data Availability: Some metrics may be available in the platform’s native interface but not through their API, or vice versa.
  • Update Frequency: Analytics are updated based on when we fetch data from each platform, which may not match the real-time updates you see in the platform’s own interface.

​
Understanding analytics

This is what we return to you in aggregated form, it ain’t much but it’s honest work.
  • Rolling Window: Analytics show aggregated data over a fixed time period (e.g., last 30 days) that updates as time progresses. Each time you view analytics, you see data for the most recent period.
  • Lifetime: Analytics show a snapshot of cumulative totals from when the post or profile was created up to the current moment. These values represent the current state and will continue to grow over time. Nothing new.

​
Instagram

​
Profile Analytics

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views (profile views)
    • Likes
    • Comments
    • Post Count
    • Followers
    • Following

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions (called “views” in Instagram API)
    • Impressions (Unique) (called “reach” in Instagram API)
    • Views (video plays for videos/reels)
    • Likes
    • Comments
    • Shares (for Reels only)
    • Saves

​
Facebook

​
Profile Analytics

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique) - uses 28-day period to avoid overcounting
    • Views (page views)
    • Likes
    • Comments
    • Post Count
    • Followers
    • Following

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views (for video posts only)
    • Views (Unique) (for video posts only)
    • Likes (aggregated from all reaction types: like, love, wow, haha, anger)
    • Comments
    • Shares
    • Saves

​
Quirks

  • Likes include all reaction types combined (like, love, wow, haha, anger)

​
LinkedIn

​
Profile Analytics

​
Personal (Member) Accounts

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views: Not available (LinkedIn doesn’t provide views for personal accounts)
    • Likes
    • Comments
    • Post Count
    • Followers
    • Following

​
Organization (Company) Accounts

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views (page views - available for organizations only)
    • Likes
    • Comments
    • Post Count
    • Followers
    • Following

​
Post Analytics

​
Personal (Member) Posts

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views (for video posts only)
    • Views (Unique) (for video posts only)
    • Likes
    • Comments
    • Shares

​
Organization Posts

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique)
    • Views: Not available (LinkedIn doesn’t provide views for organization posts)
    • Likes
    • Comments
    • Shares

​
Quirks

  • Important: Personal (member) accounts do NOT have views analytics for profiles or posts (except video views for video posts)
  • Important: Organization accounts have views (page views) for profile analytics but NOT for individual posts
  • Organization post analytics only include posts published within the last 30 days
  • Posts authored by members (not the organization/brand) are excluded from organization analytics

​
Twitter/X

​
Profile Analytics

  • Status: Not available and won’t be.

​
Post Analytics

  • Status: Not available and won’t be.

​
TikTok

​
Profile Analytics

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions (video views)
    • Impressions (Unique) (unique video views)
    • Views (same as impressions for TikTok)
    • Views (Unique) (same as unique impressions)
    • Comments
    • Likes (total likes across all videos)
    • Post Count (videos count)
    • Followers
    • Following

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions (video views)
    • Impressions (Unique) (unique video views)
    • Views (same as impressions)
    • Views (Unique) (same as unique impressions)
    • Likes
    • Comments
    • Shares

​
Quirks

  • Profile analytics aggregate daily metrics over a 30-day window
  • Post analytics are lifetime values
  • Views and unique views are tracked separately and can be 0 if platform decides that

​
YouTube

​
Profile Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions (total channel views)
    • Impressions (Unique) (same as impressions - YouTube doesn’t provide unique)
    • Views (total channel views)
    • Views (Unique) (same as views)
    • Comments (total comments across all videos)
    • Post Count (video count)
    • Followers (subscribers)
    • Following

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions (video views)
    • Impressions (Unique) (same as impressions)
    • Views (video views)
    • Views (Unique) (same as views)
    • Likes
    • Dislikes
    • Comments
    • Saves (favorites)

​
Quirks

  • All analytics are lifetime values (no rolling window)
  • YouTube doesn’t distinguish between impressions and unique impressions
  • Dislikes are available (though YouTube no longer shows dislike counts publicly, the data may still be available)

​
Threads

​
Profile Analytics

  • Period: Rolling window
  • Available Metrics:
    • Impressions (views)
    • Impressions (Unique) (same as impressions)
    • Views (same as impressions)
    • Views (Unique) (same as views)
    • Likes
    • Comments (replies)
    • Shares (reposts)
    • Post Count
    • Followers
    • Following

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions (views)
    • Impressions (Unique) (same as impressions)
    • Views (same as impressions)
    • Views (Unique) (same as views)
    • Likes
    • Comments (replies)
    • Shares (reposts + quotes)

​
Quirks

  • Views metric is used for both impressions and views (they are the same value)
  • Comments are called “replies” in Threads
  • Shares include both reposts and quotes

​
Pinterest

​
Profile Analytics

  • Period: Rolling window (30 days)
  • Available Metrics:
    • Impressions
    • Impressions (Unique) (same as impressions)
    • Views (for video pins only, otherwise same as impressions)
    • Views (Unique) (same as views)
    • Likes (saves)
    • Comments
    • Post Count
    • Followers
    • Following

​
Post Analytics

  • Period: Mixed (30-day rolling window for impressions/views, lifetime for engagement)
  • Available Metrics:
    • Impressions (30-day window)
    • Impressions (Unique) (same as impressions)
    • Views (30-day window, for video pins only)
    • Views (Unique) (same as views)
    • Likes (lifetime total reactions)
    • Comments (lifetime total)
    • Saves (30-day window)

​
Quirks

  • Profile analytics aggregate all pin analytics over the last 30 days
  • Views are only available for video pins
  • If a video pin has no views, views will show the same value as impressions

​
Reddit

​
Profile Analytics

  • Status: Limited availability
  • Details: Reddit does not provide traditional analytics. Only basic profile information is available:
    • Post Count: Not available
    • Followers: Not available
    • Following: Not available
    • Other metrics: Not available

​
Post Analytics

  • Period: Lifetime (snapshot of current totals)
  • Available Metrics:
    • Impressions: Not available
    • Impressions (Unique): Not available
    • Views (may not be available for all posts)
    • Likes (upvotes)
    • Dislikes (downvotes)
    • Comments
    • Shares (crossposts)

​
Quirks

  • Important: Reddit has very limited analytics compared to other platforms
  • No profile-level analytics (only basic account information)
  • View counts may not be available for all posts
  • No impressions or reach metrics available
  • Reddit uses upvotes/downvotes instead of likes

​
Summary Table

PlatformProfile PeriodPost PeriodKey Limitations
InstagramRolling (30d)Lifetime-
FacebookRolling (30d)LifetimeUnique impressions use 28-day period
LinkedIn (Personal)Rolling (30d)Rolling (30d)No views analytics
LinkedIn (Org)Rolling (30d)Rolling (30d)Views for profile only, not posts
Twitter/XN/AN/ANot available
TikTokRolling (30d)Lifetime-
YouTubeLifetimeLifetimeNo unique impressions
ThreadsRollingLifetimeHistorical data limitations
PinterestRolling (30d)MixedViews only for video pins
RedditN/ALifetimeVery limited analytics

​
Available Metrics Reference

​
Profile Analytics Metrics

  • Impressions: Number of times your profile/content was shown
  • Impressions (Unique): Number of unique users who saw your profile/content
  • Views: Number of times your profile/page was viewed
  • Likes: Total likes/reactions received
  • Comments: Total comments received
  • Post Count: Total number of posts published
  • Followers: Current follower count
  • Following: Current following count

​
Post Analytics Metrics

  • Impressions: Number of times the post was shown
  • Impressions (Unique): Number of unique users who saw the post
  • Views: Number of times the post was viewed (for videos, this is play count)
  • Views (Unique): Number of unique users who viewed the post
  • Likes: Total likes/reactions received
  • Dislikes: Total dislikes (YouTube, Reddit only)
  • Comments: Total comments received
  • Shares: Total shares/reposts
  • Saves: Total saves/bookmarks

​
Notes

  • Rolling Window: Data refreshes to show the most recent period (e.g., last 30 days). Each time you check analytics, you see data for the current rolling period.
  • Lifetime: Data represents cumulative totals from creation to now. These values are snapshots of the current state and will continue to grow.
  • Some platforms have date restrictions due to API limitations (e.g., Threads requires posts after April 2024).
  • LinkedIn has significant differences between personal and organization account analytics capabilities.
  • Metrics may vary slightly between platforms due to how each platform defines and tracks engagement.

​
Raw Analytics Data

In addition to the parsed analytics data described above, raw analytics data is also available. Raw analytics contain the unparsed, original data returned directly from each platform’s API. This includes:
  • Platform-specific metrics that may not be mapped to our standard schema
  • Additional metadata and context provided by the platform
  • Detailed breakdowns (e.g., audience demographics, engagement by time period, etc.)
Raw analytics can be useful for advanced analysis or when you need access to platform-specific metrics that aren’t included in the standardized analytics format. Note that raw data structure and fields vary significantly between platforms. BTW, you are a nerd for reading all of this.