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:

  • TikTok: followers, following, likes, video count
  • Threads: followers, views, likes, replies, reposts, quotes (supports date range)
  • Instagram: followers, following, media count
  • X (Twitter): followers, following, tweet count
  • YouTube: subscribers, views, video count
  • LinkedIn: followers (personal profiles and organization pages)
  • Facebook: page fans/followers
  • 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.

GET/v1/social-accounts/{id}/metrics

Path Parameters

idstring

Query Parameters

since?number

Unix timestamp for start of date range (defaults to 30 days ago)

until?number

Unix timestamp for end of date range (defaults to now)

Response Body

curl -X GET "https://api.outstand.so/v1/social-accounts/string/metrics?since=1704067200&until=1706745600"
{
  "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,
      "reposts": 10,
      "quotes": 5
    },
    "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"
}