post_mode | string or SelectableOption | No | direct | How to publish. Available options: ‘direct’ (publishes straight to the account, needs the video.publish permission) or ‘draft’ (uploads to the creator’s TikTok inbox so they finish and post it in the TikTok app, needs video.upload). In draft mode TikTok collects the caption and settings in its own editor, so the caption, privacy, and interaction fields below are only used for ‘direct’. |
video_url | string | No | - | The video to post. Accepts a direct video URL or a Google Drive share link with sharing set to ‘Anyone with the link’. Markifact downloads it and uploads it to TikTok, so it does not need to be on a verified domain. |
title | string | No | - | The caption, up to 2200 characters. Hashtags and @mentions can be included in the text. Used for ‘direct’ posts only. |
privacy_level | string or SelectableOption | No | - | Who can see the post. Required for ‘direct’ posts. Must be one of the options the account actually allows, which tiktok_get_creator_info returns in privacy_level_options: ‘PUBLIC_TO_EVERYONE’, ‘MUTUAL_FOLLOW_FRIENDS’ (friends), ‘FOLLOWER_OF_CREATOR’ (followers), ‘SELF_ONLY’ (only me). Until the TikTok app passes review, only SELF_ONLY works. |
disable_comment | boolean | No | - | Set to True to turn off comments on this post. |
disable_duet | boolean | No | - | Set to True to stop others creating Duets from this post. |
disable_stitch | boolean | No | - | Set to True to stop others stitching this post. |
video_cover_timestamp_ms | integer or string | No | - | Which frame to use as the cover, in milliseconds from the start. Defaults to the first frame. |
brand_organic_toggle | boolean | No | - | Set to True when the post promotes the creator’s own business. TikTok labels it ‘Promotional content’. |
brand_content_toggle | boolean | No | - | Set to True when the post is a paid partnership with a brand. TikTok labels it ‘Paid partnership’. TikTok does not allow branded content on private posts, so this cannot be combined with SELF_ONLY privacy. |