UniPost
Dashboard

List TikTok public videos

Returns owned public TikTok videos and engagement counters for one connected account as an optional native drilldown beyond the normalized UniPost Analytics API. TikTok has approved video.list for production use; newly connected accounts request this scope during OAuth, and older accounts may need reconnect before public video inventory is available.
https://api.unipost.dev
GET/v1/accounts/:account_id/tiktok/videos?{cursor}&{limit}
Authorization
In header · Bearer <token>
Path
string
Query

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Path Params

account_idstring
Connected TikTok account ID such as sa_tiktok_123.

Query Params

cursorOptionalnumber
Cursor returned by the previous TikTok video.list response. Defaults to 0.
limitOptionalnumber
Maximum videos to return. Defaults to 20 and caps at 20.

Response Body

200
videos[]array
Public videos returned by TikTok video.list.
videos[].idstring
TikTok video ID.
videos[].titlestring
Video title when available.
videos[].video_descriptionstring
Video description when available.
videos[].cover_image_urlstring
Cover image URL.
videos[].share_urlstring
Public share URL.
videos[].create_timenumber
Unix timestamp in seconds.
videos[].view_countnumber
View count returned by TikTok.
videos[].like_countnumber
Like count returned by TikTok.
videos[].comment_countnumber
Comment count returned by TikTok.
videos[].share_countnumber
Share count returned by TikTok.
cursornumber
Cursor for the next request.
has_moreboolean
Whether TikTok has more videos after this page.
fetched_atstring
UTC timestamp when UniPost fetched the page.
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.