Get account metrics

Fetch analytics and metrics for a connected social account. Returns follower counts, engagement metrics, and platform-specific statistics.

Supported Metrics by Platform:

• Instagram: followers, following, media count, engagement (views, likes, comments, shares, saves, reach, accounts_engaged, total_interactions), and follower_growth (followers_gained, followers_lost, net_follower_change, daily_new_followers) - requires Business/Creator account with instagram_business_manage_insights permission (supports date range). Instagram omits follower growth for accounts with fewer than 100 followers; those fields are null and listed in follower_growth.unavailable_fields
• Facebook: page followers/fans, engagement (impressions, reach, post_engagements) - requires pages_read_engagement and read_insights, supports date range. Since Meta's June 2026 deprecation, impressions and reach are derived from media views and read lower than the retired impression metrics; metrics Meta did not return are listed in platform_specific.insights_unavailable
• Threads: followers, engagement (views, likes, replies, reposts, quotes) - supports date range
• LinkedIn: followers (personal & organization), engagement for organizations (likes, comments, shares, clicks, impressions, engagement_rate) - requires rw_organization_admin permission, supports date range
• TikTok: followers, following, total likes, video count - current snapshot only, no date range support
• YouTube: subscribers, total views, video count - lifetime statistics only, no date range support
• X (Twitter): followers, following, tweet count (current snapshot), plus engagement (views, likes, comments, shares, quotes) aggregated from up to 500 of the account's own tweets posted within the date range. Aggregation is best-effort and may be unavailable under X API rate limits or tier restrictions. Cost note: this reads posts from your connected X app and counts against your X API quota / pay-per-use cost (~$0.005 per post read); a busy account can cost up to ~$2.50 per call. Date range supported.
• BlueSky: followers, following, posts count - current snapshot only (Bluesky exposes no time-series analytics, so the date range is ignored). No engagement metrics.
• Pinterest: followers, following, pin count (posts_count includes both created and saved pins, per Pinterest's API), engagement (views/impressions, saves, pin_clicks, outbound_clicks); full daily analytics available under platform_specific. Date range supported.

Date Range: Use since and until query parameters for platforms that support historical data. Defaults to last 30 days.

fetch("https://api.outstand.so/v1/social-accounts/string/metrics?since=1704067200&until=1706745600", {  method: "GET"})

{
  "success": true,
  "data": {
    "account_id": "9dyJS",
    "network": "tiktok",
    "followers_count": 10000,
    "following_count": 500,
    "posts_count": 150,
    "engagement": {
      "views": 15000,
      "likes": 500,
      "comments": 75,
      "shares": 25,
      "saves": 10,
      "reposts": 10,
      "quotes": 5,
      "reach": 5000,
      "accounts_engaged": 200,
      "total_interactions": 600,
      "replies": 12,
      "profile_links_taps": 30
    },
    "stories": {
      "views": 0,
      "reach": 0,
      "total_interactions": 0,
      "replies": 0
    },
    "follower_growth": {
      "followers_gained": 42,
      "followers_lost": 9,
      "net_follower_change": 33,
      "daily_new_followers": [
        {
          "end_time": "2026-10-01T07:00:00+0000",
          "value": 3
        }
      ],
      "unavailable_fields": []
    },
    "platform_specific": {
      "property1": null,
      "property2": null
    },
    "period": {
      "since": 1704067200,
      "until": 1706745600,
      "note": "This platform returns current snapshot, not historical data"
    },
    "fetched_at": "2025-01-15T10:30:00Z"
  }
}

{
  "success": false,
  "error": [
    null
  ],
  "data": null
}

{
  "success": false,
  "error": "Social account not found"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}