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) — requires Business/Creator account with instagram_business_manage_insights permission (supports date range)
• Facebook: page followers/fans, engagement (impressions, engaged_users, post_engagements, consumptions) — supports date range
• 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 — no engagement data (requires Premium API)
• BlueSky: Limited support (returns null metrics)

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
    },
    "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": "Social account not found"
}

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