Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Post settings sa TikTok API: privacy, comments, Duet at Stitch

Tinatanggap ng API for Business ng TikTok ang settings ng post sa publish call, karamihan sa loob ng post_info. Para sa video, ginagamit ang disable_comment, disable_duet at disable_stitch, cover mula sa thumbnail_offset o custom_thumbnail_url, mga label na is_brand_organic at is_branded_content, at is_ai_generated. Para sa photo post, ginagamit ang privacy_level, disable_comment, parehong brand label, at auto_add_music. Ibinabalik ng GET /business/video/settings/ ang mga value na pinapayagan ng bawat account.

Nagpo-publish ang easyCoexistence ng mga video at photo post sa TikTok gamit ang publish_tiktok_post mula sa Claude, ChatGPT o sarili ninyong code, kasama ang caption, title ng photo post, at comments na naka-on o naka-off, at ibinibigay ng get_social_credentials sa sarili ninyong code ang token para basahin ang pinapayagang settings ng account.

3 levels

Mga privacy option para sa photo post ng pampublikong account: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS at SELF_ONLY.

FOLLOWER_OF_CREATOR

Privacy level na makukuha ng pribadong account sa halip na PUBLIC_TO_EVERYONE: nakikita lamang ng mga follower nito.

false

Default ng disable_comment, disable_duet at disable_stitch, kaya nananatiling bukas ang comments, Duet at Stitch maliban kung itatakda.

1080 x 1920

Custom cover image ng video, na dapat hindi bababa sa 360 x 360 pixels at hanggang 20 MB.

Paid partnership

Ang label na is_branded_content ang nananaig kapag true rin ang is_brand_organic.

privacy_level

Kinakailangang field ng post_info ng photo post, limitado sa mga option na ibinabalik ng GET /business/video/settings/ para sa account.

Aling settings ang tinatanggap ng bawat publish endpoint?

Ang /business/video/publish/ at /business/photo/publish/ ay may ilang settings na magkapareho at may ilang magkaiba. Karamihan ay nasa loob ng post_info, habang ang custom_thumbnail_url at photo_cover_index ay nasa top level ng body. Magkatabi, gaya ng nakalista sa reference ng TikTok, at may No field kung walang nakadokumentong setting ang endpoint para sa partikular na setting:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Ano ang pinapayagan ng account?

Ibinabalik ng GET /business/video/settings/ kasama ang business_id ang mga limit ng account sa mga post nito. Basahin muna ito bago mag-publish, dahil tatanggapin lamang ng TikTok ang mga value na nakalista rito:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS at SELF_ONLY para sa pampublikong account; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS at SELF_ONLY para sa pribado.
  • comment_disabled: true kapag walang pinapayagang mag-comment sa account, at tatanggap lamang ng true ang disable_comment.
  • duet_disabled at stitch_disabled: true kapag pinapayagan lamang ng account ang Duet o Stitch mula sa Only you, o kung pribado ito; tatanggap lamang ng true ang kaukulang switch.
  • max_video_post_duration_sec: ang pinakamahabang video na maaaring i-publish ng account; mabibigo ang mas mahabang video.
Read an account's post settings
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
  }
}

Sino ang makakakita ng post?

Sa photo post, ang privacy_level na ipapadala ninyo: PUBLIC_TO_EVERYONE para sa mga tao sa loob o labas ng TikTok, MUTUAL_FOLLOW_FRIENDS para sa mga follower na sinusundan din ng account, FOLLOWER_OF_CREATOR para sa mga follower ng pribadong account, o SELF_ONLY. Walang privacy field ang video endpoint, dahil nagpo-publish ito ng pampublikong video post. Hindi rin mapapanood sa pamamagitan ng embed_url ang post na nakatakda sa Friends o Only you.

Paano gumagana ang comments, Duet at Stitch?

Bawat isa ay switch na nagpapatay ng feature kapag itinakda sa true. Nasa parehong endpoint ang disable_comment; ang disable_duet at disable_stitch ay nasa video lamang. Lahat ay naka-default sa false, kaya bukas ang feature, sa loob ng pinapayagan ng sariling privacy settings ng account: ang account na walang pinapayagang mag-comment, o naglilimita ng Duet o Stitch sa Only you, ay maaari lamang mag-publish kapag true ang kaukulang switch.

Paano pinipili ang cover?

Sa video, may dalawang paraan. Pinipili ng post_info.thumbnail_offset ang frame base sa oras nito sa milliseconds, 0 bilang default, at ina-round up sa pinakamalapit na frame; kapag lampas sa dulo ng video ang oras, magpapadala ng failure webhook at hindi ma-publish ang video. Ang custom_thumbnail_url, sa top level ng body, ay nagbibigay ng image at pinababalewala ng TikTok ang offset. Sa photo post, pinipili ng photo_cover_index ang isa sa mga image, na nagbibilang mula 0.

  • Custom cover image: JPG, JPEG, WebP o PNG, hanggang 20 MB.
  • Laki: mula 360 x 360 pixels hanggang 1080 x 1920, o 1920 x 1080.
  • Lokasyon: domain o URL prefix na na-verify para sa app, gaya ng mismong video.

Ano ang ibig sabihin ng brand labels?

Mga disclosure na ipinapakita ng TikTok sa post. Ang is_brand_organic na true ay naglalagay ng label na Promotional content, para sa post na nagpo-promote ng sariling negosyo ng account. Ang is_branded_content na true ay naglalagay ng label na Paid partnership, para sa post na ginawa sa bayad na partnership sa isang brand, at nananaig kapag true ang pareho. Sa video na may is_branded_content, maaaring i-link ng tto_invite_link ang post sa isang kampanya ng TikTok One Creator Marketplace na sinalihan ng account.

Anu-ano pa ang option sa post_info?

Ilan pa, bawat isa ay nakadokumento sa endpoint na tumatanggap nito:

  • is_ai_generated, video: nilalagyan ng label na Creator labeled as AI-generated ang post, na hindi na mababago kapag na-post na.
  • location_id kasama ang location_name: location tag na makukuha sa pamamagitan ng GET /business/publish/location/.
  • music_sound_info: commercial sound sa pamamagitan ng ID; sa video, kasama rin ang volume nito, 0 hanggang 100, at ang simula at dulo nito sa milliseconds.
  • auto_add_music, photo post: nagdadagdag ng inirerekomendang musika, na maaaring palitan sa TikTok app.
  • upload_to_draft o is_draft: ipinapadala ang post sa inbox ng creator bilang draft, kasama ang video, na may video.upload scope.
  • is_ads_only, video: nagpo-publish ng Only show in ads post na hindi lumalabas sa profile.

Aling settings ang itinatakda ng publish_tiktok_post?

Tatlo ay galing sa request ninyo: ang caption, ang title ng photo post, at ang disable_comment. Ipinapadala ng easyCoexistence ang is_brand_organic at is_branded_content bilang false, ipina-publish ang photo post bilang PUBLIC_TO_EVERYONE, at ang unang image ang cover, at iniiwan ang natitirang settings ng video, kaya ang default ng TikTok ang nalalapat: disable_duet at disable_stitch na false, thumbnail_offset na 0, at is_ai_generated na false.

Paano ipinapadala ang iba pang settings?

Mula sa sarili ninyong code, gamit ang token at business_id ng account mula sa get_social_credentials, sa mga Business API path sa ilalim ng business/. Binabasa ng GET sa business/video/settings/ ang mga limit ng account. Ang POST sa business/video/publish/ o business/photo/publish/ ay maaaring magdala ng buong nakadokumentong body, at dumarating ito sa TikTok gaya ng pagkakasulat, kasama ang media URL, kaya dapat nasa domain o URL prefix na na-verify para sa app ang mga ito; ang publish_tiktok_post ang tawag na dumadaan sa link ninyo sa verified media route ng easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Mga karaniwang pagkakamali

  • Inaakalang gagana ang privacy_level sa video. Nagpo-publish ng pampublikong post ang video endpoint at walang privacy field sa reference nito; tumatanggap ng privacy_level ang photo post.
  • Pagbubukas ng comments sa account na walang pinapayagang mag-comment. Kapag true ang comment_disabled, tatanggap lamang ng true ang disable_comment ng TikTok.
  • Pagtatakda ng thumbnail_offset na lampas sa dulo ng video. Magpapadala ang TikTok ng failure webhook at hindi ma-publish ang video.
  • Pagpapadala ng PUBLIC_TO_EVERYONE para sa pribadong account. Ang privacy_level_options nito ay FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS at SELF_ONLY ang nakalista.
Ginagawa ito gamit ang EasyCoexistence

US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Puwede ba akong mag-post ng pribadong TikTok video sa pamamagitan ng API?

Hindi sa video endpoint, dahil nagpo-publish ito ng pampublikong post. Tumatanggap ng privacy_level ang photo post, kasama ang SELF_ONLY, at maaaring ipadala ang video sa inbox ng creator bilang draft gamit ang upload_to_draft.

Paano i-off ang Duet at Stitch sa pamamagitan ng API?

Itakda ang post_info.disable_duet at post_info.disable_stitch sa true sa /business/video/publish/. Kapag nililimitahan na ng account ang mga ito, tatanggap lamang ng true ang TikTok.

Puwede ba akong magdagdag ng location tag sa TikTok API?

Oo. Tumatanggap ang post_info ng location_id kasama ang location_name, para sa location tag na makukuha sa pamamagitan ng GET /business/publish/location/.

Ano ang pagkakaiba ng is_brand_organic at is_branded_content?

Naglalagay ang is_brand_organic ng label na Promotional content para sa sariling negosyo ng account; naglalagay naman ang is_branded_content ng label na Paid partnership at nananaig kapag true ang pareho.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong