Get TikTok profile

Returns TikTok profile fields for one connected account as an optional native drilldown beyond the normalized UniPost Analytics API. TikTok has approved user.info.profile for production use; newly connected accounts request this scope during OAuth, and older accounts may need reconnect before profile data is available.
https://api.unipost.dev
GET/v1/accounts/:account_id/tiktok/profile
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".
open_idstring
TikTok OpenID for the connected user.
display_namestring
TikTok display name from user.info.profile.
avatar_urlstring
Avatar image URL from TikTok.
usernamestring
TikTok username without the @ prefix.
profile_web_linkstring
Canonical web profile URL when TikTok returns it.
profile_deep_linkstring
TikTok app deep link when TikTok returns it.
bio_descriptionstring
Profile bio text.
is_verifiedboolean
Whether TikTok reports the account as verified.
fetched_atstring
UTC timestamp when UniPost fetched the profile.
401
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, NEEDS_RECONNECT, or TIKTOK_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, NOT_FOUND, WRONG_PLATFORM, NEEDS_RECONNECT, or TIKTOK_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, NOT_FOUND, WRONG_PLATFORM, NEEDS_RECONNECT, or TIKTOK_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, NOT_FOUND, WRONG_PLATFORM, NEEDS_RECONNECT, or TIKTOK_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, NOT_FOUND, WRONG_PLATFORM, NEEDS_RECONNECT, or TIKTOK_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.