Get account metrics across platforms
Use one UniPost account metrics endpoint for follower, following, and post counts across supported connected accounts.
When to use this guide
Use GET/v1/accounts/{account_id}/metrics when your product needs account-level metrics such as followers, following, lifetime post count, or platform-specific account stats. This is the normalized UniPost path for X, Instagram, Threads, TikTok, and YouTube when the connected account has the required platform scopes.
Steps
- List connected accounts with GET/v1/accounts.
- Pick the account id for the platform you want to display.
- Call GET/v1/accounts/{account_id}/metrics.
- Read the normalized fields first, then inspect
platform_specificfor platform-native additions.
Request
Fields to read
| Field | Meaning |
|---|---|
data.follower_count | Followers reported by the platform. |
data.following_count | Accounts this account follows, when the platform exposes it. |
data.post_count | Lifetime post, video, or media count exposed by the platform. |
data.platform_specific | Provider-native additions or upstream failure details that do not fit the normalized shape. |
Platform notes
TikTok followers require user.info.stats; likes count appears in platform_specific.likes_count.
Instagram and Threads require the approved account insight scopes documented in platform capabilities.
YouTube account metrics use the YouTube Data API channel statistics available through youtube.readonly. UniPost maps subscriberCount to follower_count, returns following_count as 0 with platform_specific.following_count_supported set to false, and maps videoCount to post_count. If subscribers are hidden, follower_count is 0 and platform_specific.hidden_subscriber_count is true.
For richer YouTube reporting, use YouTube Analytics V2. In the dashboard, Analytics - Platforms - YouTube combines this V1 channel snapshot with V2 summary, daily trend, and top video reports.
X account metrics depend on X API availability and rate limits for the connected account.
Unsupported platforms return NOT_SUPPORTED instead of an empty success response.