Skip to main content

tiktok

tiktok.account_stats

TikTok account stats

Effects: read

Get the connected TikTok account's profile (username, display name, avatar) and stats (followers, following, likes, videos).

Arguments

No arguments.

tiktok.list_videos

List TikTok videos

Effects: read

List videos on the connected TikTok account. Returns id, title, share_url, view/like/comment/share counts. Paginate via cursor.

Arguments

ArgumentTypeRequiredDescription
cursorintegernoPagination cursor from a previous call's cursor. Omit for the first page.
max_countintegernoPage size, 1-20. Default 20.

tiktok.publish_video

Publish video to TikTok

Effects: write

Publish a workspace-owned video file (file_id) to the connected TikTok account via the Content Posting API. Returns publish_id + final status. Note: until the TikTok app audit passes, TikTok forces SELF_ONLY (private) visibility.

Arguments

ArgumentTypeRequiredDescription
channel_account_idintegernoConnected TikTok channel_account.id. OMIT to auto-resolve the workspace's account.
disable_commentbooleannoDisable comments on the post.
disable_duetbooleannoDisable duets.
disable_stitchbooleannoDisable stitches.
file_idintegeryesWorkspace files.id of the video to publish. Must be a video/* MIME type and status='ready'.
privacy_levelstringnoPost visibility. Must be one the creator allows (checked against creator_info). Default SELF_ONLY — the only level TikTok accepts from unaudited apps. (one of SELF_ONLY, PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR; default SELF_ONLY)
titlestringyesPost caption/title (max 2200 chars; hashtags allowed).