Get account metrics
Returns follower / following / post counts for one connected social account, fetched live from the platform's API. Currently supported on X (Twitter). TikTok account metrics are implemented behind TikTok's analytics scopes and should be treated as unavailable in production until those scopes are approved and enabled. Other platforms return 501 NOT_SUPPORTED. Not cached — every call hits the upstream API, so prefer caching client-side if your dashboard polls frequently.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
account_idstring
Connected social account ID such as sa_twitter_1.
Response Body
200
social_account_idstring
UniPost account ID the metrics snapshot belongs to.
platformstring
Normalized platform name.
follower_countnumber
Followers reported by the platform at fetch time.
following_countnumber
Number of accounts this account is following.
post_countnumber
Lifetime post / tweet count exposed by the platform.
platform_specificobject
Untransformed platform-native fields. On X: tweet_count, listed_count. On TikTok, after analytics scopes are approved and enabled, likes_count is included. When the upstream call fails (rate-limited, tier-restricted, missing scope, etc.), follower/following/post counts come back as 0 and platform_specific carries upstream_status (HTTP code from the platform) and upstream_error (response body) — branch on the presence of upstream_status to distinguish a real zero account from an upstream failure.
fetched_atstring
Timestamp at which the response was fetched. Not cached — every call hits the upstream platform API.
401
error.codestring
Possible values: "UNAUTHORIZED", "NOT_FOUND", "ACCOUNT_DISCONNECTED" (409), "NOT_SUPPORTED" (501 — platform has no metrics endpoint), "UPSTREAM_ERROR" (502 — platform fetch failed), "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "not_found", "account_disconnected", "not_supported", "upstream_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Possible values: "UNAUTHORIZED", "NOT_FOUND", "ACCOUNT_DISCONNECTED" (409), "NOT_SUPPORTED" (501 — platform has no metrics endpoint), "UPSTREAM_ERROR" (502 — platform fetch failed), "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "not_found", "account_disconnected", "not_supported", "upstream_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
409
error.codestring
Possible values: "UNAUTHORIZED", "NOT_FOUND", "ACCOUNT_DISCONNECTED" (409), "NOT_SUPPORTED" (501 — platform has no metrics endpoint), "UPSTREAM_ERROR" (502 — platform fetch failed), "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "not_found", "account_disconnected", "not_supported", "upstream_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
501
error.codestring
Possible values: "UNAUTHORIZED", "NOT_FOUND", "ACCOUNT_DISCONNECTED" (409), "NOT_SUPPORTED" (501 — platform has no metrics endpoint), "UPSTREAM_ERROR" (502 — platform fetch failed), "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "not_found", "account_disconnected", "not_supported", "upstream_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
502
error.codestring
Possible values: "UNAUTHORIZED", "NOT_FOUND", "ACCOUNT_DISCONNECTED" (409), "NOT_SUPPORTED" (501 — platform has no metrics endpoint), "UPSTREAM_ERROR" (502 — platform fetch failed), "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "not_found", "account_disconnected", "not_supported", "upstream_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.