Insights

Get various metrics for posts within a specified time frame.

Returns post metric snapshots grouped by calendar date in the authenticated user's timezone for selected metric types. Published posts and metric samples are limited to the selected local dates; calculate_growth retains its existing day-over-day semantics.

get/insights/posts/metrics

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/insights/posts/metrics
  • Auth: HTTP bearer

Query parameters

post_type'image' | 'video' | 'text'

Filter by post type. If omitted, all post types are included.

startstring date required

Format should be Y-m-d

The start date

endstring date required

Format should be Y-m-d

The end date

string required
OR
string[] required

The metric types you want to fetch. Accepts either a comma-separated string or repeated query parameters such as metrics[]=impressions&metrics[]=engagement. Use engagements for a combined interaction series that excludes views and reach. For each post, total_interactions takes precedence over its individual action metrics when present in the queried samples (including the growth baseline). Otherwise, action metrics such as likes, comments, replies, shares, and saves are combined. Daily growth is calculated per source counter before combining. Missing total samples do not fall back to components. Explicitly requested raw metrics are returned separately unchanged. Supported post metrics for each network:

  • Facebook Page:
    • All posts: reactions, comments
    • Text posts: shares
    • Non-video posts: media_view (impressions), clicks
    • Video posts: video_views, video_views_paid, video_views_organic, video_complete_views, video_10s_views, video_avg_time_watched, avg_watch_time, video_view_time, total_plays, replay_count, impressions, impressions_paid, impressions_organic, impressions_fan, impressions_unique
    • Stories are not tracked.
  • Instagram:
    • All posts: likes, comments
    • Carousel posts: reach, saved
    • Photo posts: reach, saved
    • Video posts: reach, saved
    • Reel posts: reach, saved, shares, total_interactions
    • Story posts: reach, replies
  • Twitter / X: bookmarks, retweets, likes, replies, quote_tweets, impressions
  • LinkedIn Org & Brand: clicks, comments, engagement, impressions, likes, shares, unique_impressions, video_views (video only)
  • LinkedIn Profile: comments, impressions, likes, shares, unique_impressions
  • YouTube: views, likes, comments
  • Pinterest:
    • All posts: impressions, pin_clicks, saved, reactions, comments
    • Video posts: video_views, video_avg_watch_time, video_10s_views
  • Threads: views, likes, replies, reposts, quotes
  • Bluesky: likes, replies, reposts
  • Mastodon: replies, reblogs, favourites
  • Reddit Profile & Subreddit: comments, score
  • TikTok: (post metrics not supported)
  • Google Business Location: (post metrics not supported)
calculate_growthboolean

Whether to return day-over-day deltas from cumulative metric values. Defaults to true.

group_by_accountboolean

Whether to group the response by account.

  • false (default): returns summed metrics across selected accounts.
  • true: returns metrics per account.
accountsinteger[]

An array of account IDs.

teaminteger

The team id.

Response

successful operation

Changes

No recorded changes to this operation across all 1 revision of this API.