TikTok post settings through the API: privacy, comments, duet and stitch
TikTok's API for Business takes a post's settings in the publish call, mostly inside post_info. Videos take disable_comment, disable_duet and disable_stitch, a cover from thumbnail_offset or custom_thumbnail_url, the is_brand_organic and is_branded_content labels and is_ai_generated. Photo posts take privacy_level, disable_comment, the same brand labels and auto_add_music. GET /business/video/settings/ returns the values each account allows.
easyCoexistence publishes TikTok videos and photo posts with publish_tiktok_post from Claude, ChatGPT or your own code, with the caption, a photo post's title and comments on or off, and get_social_credentials gives your own code the token to read the account's allowed settings.
Privacy options for a public account's photo posts: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS and SELF_ONLY.
Privacy level a private account gets in place of PUBLIC_TO_EVERYONE: visible to its followers only.
Default of disable_comment, disable_duet and disable_stitch, so comments, Duets and Stitches stay on unless set.
Largest custom cover image for a video, which must be at least 360 x 360 pixels and up to 20 MB.
Label is_branded_content attaches; it wins when is_brand_organic is also true.
Required field of a photo post's post_info, limited to the options GET /business/video/settings/ returns for the account.
Which settings does each publish endpoint take?
/business/video/publish/ and /business/photo/publish/ share some settings and differ on others. Most sit inside post_info, while custom_thumbnail_url and photo_cover_index sit at the top level of the body. Side by side, as TikTok's references list them, with No field where an endpoint documents nothing for that setting:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
What does the account allow?
GET /business/video/settings/ with business_id returns the account's limits on its posts. Read it before publishing, since TikTok accepts only the values it lists:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSandSELF_ONLYfor a public account;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSandSELF_ONLYfor a private one.comment_disabled: true when the account takes comments from no one, and thendisable_commentaccepts only true.duet_disabledandstitch_disabled: true when the account allows Duet or Stitch from Only you, or is private; the matching switch then accepts only true.max_video_post_duration_sec: the longest video the account can publish; a longer one fails.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Who can see the post?
On a photo post, the privacy_level you send: PUBLIC_TO_EVERYONE for people on or off TikTok, MUTUAL_FOLLOW_FRIENDS for followers the account follows back, FOLLOWER_OF_CREATOR for the followers of a private account, or SELF_ONLY. The video endpoint has no privacy field, since it publishes public video posts. A post set to Friends or Only you cannot be watched through its embed_url either.
How do comments, Duet and Stitch work?
Each is a switch that turns a feature off when set to true. disable_comment exists on both endpoints; disable_duet and disable_stitch exist on videos only. All default to false, which leaves the feature on, within what the account's own privacy settings allow: an account that takes comments from no one, or limits Duet or Stitch to Only you, can only publish with that switch set to true.
How is the cover chosen?
On a video, two ways. post_info.thumbnail_offset picks a frame by its time in milliseconds, 0 by default, rounded up to the closest frame; a time past the video's end sends a failure webhook and the video is not published. custom_thumbnail_url, at the top level of the body, gives an image instead and makes TikTok ignore the offset. On a photo post, photo_cover_index picks one of the images, counting from 0.
- Custom cover image: JPG, JPEG, WebP or PNG, up to 20 MB.
- Size: from 360 x 360 pixels up to 1080 x 1920, or 1920 x 1080.
- Location: a domain or URL prefix verified for the app, like the video itself.
What do the brand labels mean?
Disclosures that TikTok shows on the post. is_brand_organic set to true labels it Promotional content, for posts promoting the account's own business. is_branded_content set to true labels it Paid partnership, for posts made in a paid partnership with a brand, and takes precedence when both are true. On a video with is_branded_content, tto_invite_link can link the post to a TikTok One Creator Marketplace campaign the account has joined.
Which other options sit in post_info?
A few more, each documented on the endpoint that takes it:
is_ai_generated, videos: labels the post Creator labeled as AI-generated, which cannot be changed once posted.location_idwithlocation_name: a location tag found through GET /business/publish/location/.music_sound_info: a commercial sound by ID; on videos also its volume, 0 to 100, and its start and end in milliseconds.auto_add_music, photo posts: adds recommended music, which can be changed later in the TikTok app.upload_to_draftoris_draft: sends the post to the creator's inbox as a draft, with the video.upload scope.is_ads_only, videos: publishes an Only show in ads post that stays off the profile.
Which settings does publish_tiktok_post set?
Three come from your request: the caption, a photo post's title, and disable_comment. easyCoexistence sends is_brand_organic and is_branded_content as false, publishes photo posts as PUBLIC_TO_EVERYONE with the first image as the cover, and leaves the rest of a video's settings out, so TikTok's defaults apply: disable_duet and disable_stitch false, thumbnail_offset 0 and is_ai_generated false.
How do you send the other settings?
From your own code, with the account's token and business_id from get_social_credentials, on Business API paths under business/. A GET to business/video/settings/ reads the account's limits. A POST to business/video/publish/ or business/photo/publish/ can carry the full documented body, and it reaches TikTok as written, media URLs included, so they have to sit on a domain or URL prefix verified for the app; publish_tiktok_post is the call that routes your link through easyCoexistence's verified media route.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Common mistakes
- Expecting privacy_level to work on a video. The video endpoint publishes public posts and its reference lists no privacy field; photo posts take privacy_level.
- Turning comments on for an account that takes none. When comment_disabled is true, TikTok accepts disable_comment only as true.
- Setting thumbnail_offset past the video's end. TikTok sends a failure webhook and the video is not published.
- Sending PUBLIC_TO_EVERYONE for a private account. Its privacy_level_options list FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS and SELF_ONLY instead.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can I post a private TikTok video through the API?
Not with the video endpoint, which publishes public posts. Photo posts take privacy_level, SELF_ONLY included, and a video can go to the creator's inbox as a draft with upload_to_draft.
How do I turn off Duets and Stitches through the API?
Set post_info.disable_duet and post_info.disable_stitch to true on /business/video/publish/. When the account already limits them, TikTok accepts only true.
Can I add a location tag through the TikTok API?
Yes. post_info takes location_id with location_name, for a location tag found through GET /business/publish/location/.
What is the difference between is_brand_organic and is_branded_content?
is_brand_organic adds a Promotional content label for the account's own business; is_branded_content adds a Paid partnership label and wins when both are true.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on