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 (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
    },
    "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"
}