Get TikTok account metrics

Returns account-level TikTok statistics for one connected account as an optional native drilldown beyond the normalized UniPost Analytics API. TikTok has approved user.info.stats for production use; newly connected accounts request this scope during OAuth, and older accounts may need reconnect before account statistics are available.
https://api.unipost.dev
GET/v1/accounts/:account_id/metrics
Authorization
In header · Bearer <token>
Path
string

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Path Params

account_idstring
Connected TikTok account ID such as sa_tiktok_123.

Response Body

200
social_account_idstring
UniPost account ID.
platformstring
Always "tiktok" for this guide.
follower_countnumber
Follower count from user.info.stats.
following_countnumber
Following count from user.info.stats.
post_countnumber
Public video count from user.info.stats.
platform_specific.likes_countnumber
Total profile likes returned by TikTok.
platform_specific.video_countnumber
TikTok's native video count alias.
fetched_atstring
UTC timestamp when UniPost fetched the metrics.
401
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
403
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
409
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
501
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
502
error.codestring
UNAUTHORIZED, ACCOUNT_DISCONNECTED, NOT_FOUND, NEEDS_RECONNECT, NOT_SUPPORTED, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.