TikTok Posting API: Upload Videos

API id: tiktok

At a glance


Caption	2,200 characters
Files per post	Exactly 1 video
File needed?	Yes
Threads	No
Edit after publish	No
Delete after publish	No — TikTok does not let apps delete videos
Analytics	Views, impressions, likes, comments, shares
Comments	No. TikTok does not offer this to apps.

Files

Video only: MP4 or MOV.
The longest video allowed depends on the account. TikTok decides this per creator.

Options

Key	Type	What it does
`privacy_level`	choice	Required. Who can see the video, for example `PUBLIC_TO_EVERYONE` or `SELF_ONLY`. The allowed values depend on the account.
`allow_comment`	true / false	Let viewers comment.
`allow_duet`	true / false	Let others film next to your video.
`allow_stitch`	true / false	Let others use a clip of your video in theirs.
`video_cover_timestamp_ms`	text	Which frame to use as cover, in milliseconds. Default: the first frame.
`disclose_content`	true / false	Turn on if the video promotes a brand, product or service. Then set at least one of the two below.
`brand_organic_toggle`	true / false	You promote yourself or your own business.
`brand_content_toggle`	true / false	You promote another brand for payment. Cannot be used with `privacy_level: SELF_ONLY`.
`is_aigc`	true / false	Adds TikTok's "AI-generated" label.

Remember: true / false values are sent as the strings "true" and "false".

Example

{
  "channelId": "CHANNEL_TIKTOK",
  "options": {
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "allow_comment": "true",
    "allow_duet": "false",
    "allow_stitch": "false"
  },
  "blocks": [{ "content": "Behind the scenes 🎬", "mediaIds": ["VIDEO_ID"] }]
}

Good to know

Unaudited apps can only post privately

Until TikTok approves your app in its review, TikTok only allows SELF_ONLY (private) posts, whatever you send.

If you send a privacy_level the account does not allow, the account's allowed setting is used when the video is published.
By turning on brand_organic_toggle or brand_content_toggle, you agree to TikTok's Music Usage Confirmation (and Branded Content Policy for branded content).

Set up

To connect accounts, you first need your own app on this platform. See the TikTok app setup guide.