Insights

Get various metrics for accounts within a specified time frame.

Returns account metric series grouped by calendar date in the authenticated user's timezone for Analytics-permitted accounts. The latest snapshot is the latest available value and may fall outside the requested date range.

get/insights/accounts/metrics

Request

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

Query parameters

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

Metric types to fetch. Accepts either a comma-separated string or repeated query parameters such as metrics[]=followers&metrics[]=followers_by_country/*.

Wildcard patterns — some metrics are keyed as {prefix}/{value} where the suffix represents a dimension (country code, age/gender bracket, industry, etc.). You can request all values for a dimension using * as the suffix, or request a single value by providing the exact key:

PatternWhat * representsExample exact key
followers_by_country/*ISO 3166-1 alpha-2 country codefollowers_by_country/US
followers_by_gender_age/*Age bracket + gender code — M, F, or U (Instagram)followers_by_gender_age/25-34_M
fans_by_country/*ISO 3166-1 alpha-2 country code (Facebook)fans_by_country/GB
fan_adds_by_paid_non_paid_unique/*paid or unpaid (Facebook)fan_adds_by_paid_non_paid_unique/paid
followers_by_industry/*LinkedIn industry URNfollowers_by_industry/urn:li:industry:4
followers_by_function/*LinkedIn job function URNfollowers_by_function/urn:li:function:8
followers_by_seniority/*LinkedIn seniority URNfollowers_by_seniority/urn:li:seniority:4
followers_by_staff_count_range/*LinkedIn company size bucketfollowers_by_staff_count_range/SIZE_11_TO_50
views_by_country/*ISO 3166-1 alpha-2 country code (LinkedIn)views_by_country/DE

Supported account metrics for each network:

  • Facebook Page:
    • Daily: total_actions, post_engagements, impressions, fans, fan_adds_by_paid_non_paid_unique/*, fans_by_country/*, video_views, video_views_paid, video_views_organic, video_complete_views_30s, video_view_time, views_total
    • Lifetime: post_clicks, post_video_avg_time_watched
  • Instagram: followers, reach, profile_views, accounts_engaged, total_interactions, likes, comments, shares, saves, replies, views, followers_by_country/*, followers_by_gender_age/*
  • Twitter / X: followers, verified_followers
  • LinkedIn Org & Brand: followers, followers_by_staff_count_range/*, followers_by_industry/*, followers_by_function/*, followers_by_seniority/*, views_by_country/*, total_views
  • LinkedIn Profile: (no account metrics)
  • YouTube: views, subscribers, videos
  • Google Business Location: desktop_map_views, mobile_map_views, actions_website, actions_phone, actions_driving_directions, reviews
  • TikTok: followers, following, likes, videos
  • Threads: views, likes, replies, reposts, quotes, followers_count
  • Bluesky: followers
  • Mastodon: followers
  • Pinterest: followers, monthly_views, and dynamic summary analytics keys (e.g. impression, engagements, pin_click, save)
  • Reddit Profile: historical karma data only; new karma collection is unavailable
  • Reddit Subreddit: subscribers (member count), active_users (activity snapshot; new collection uses weekly active users, when available). Use calculate_growth=false to retrieve counts rather than changes between snapshots.
calculate_growthboolean

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

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.