Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Setările postărilor TikTok prin API: confidențialitate, comentarii, Duet și Stitch

API-ul TikTok for Business primește setările unei postări în apelul de publicare, în cea mai mare parte în post_info. Videoclipurile primesc disable_comment, disable_duet și disable_stitch, o copertă din thumbnail_offset sau custom_thumbnail_url, etichetele is_brand_organic și is_branded_content și is_ai_generated. Postările cu fotografii primesc privacy_level, disable_comment, aceleași etichete de brand și auto_add_music. GET /business/video/settings/ returnează valorile permise fiecărui cont.

easyCoexistence publică videoclipuri TikTok și postări cu fotografii prin publish_tiktok_post, din Claude, ChatGPT sau din propriul cod, cu legenda, titlul unei postări cu fotografii și comentariile activate sau dezactivate, iar get_social_credentials oferă propriului cod token-ul pentru citirea setărilor permise ale contului.

3 levels

Opțiunile de confidențialitate pentru postările cu fotografii ale unui cont public: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS și SELF_ONLY.

FOLLOWER_OF_CREATOR

Nivelul de confidențialitate primit de un cont privat în locul PUBLIC_TO_EVERYONE: vizibil doar pentru urmăritorii săi.

false

Valoarea implicită a disable_comment, disable_duet și disable_stitch, deci comentariile, Duet-urile și Stitch-urile rămân active dacă nu sunt setate altfel.

1080 x 1920

Cea mai mare imagine de copertă personalizată pentru un video, care trebuie să aibă cel puțin 360 x 360 pixeli și cel mult 20 MB.

Paid partnership

Eticheta is_branded_content se aplică și câștigă atunci când is_brand_organic este și el true.

privacy_level

Câmp obligatoriu din post_info al unei postări cu fotografii, limitat la opțiunile pe care le returnează GET /business/video/settings/ pentru cont.

Ce setări primește fiecare endpoint de publicare?

/business/video/publish/ și /business/photo/publish/ au unele setări comune și altele diferite. Cele mai multe se află în post_info, în timp ce custom_thumbnail_url și photo_cover_index se află la nivelul superior al corpului cererii. Una lângă alta, așa cum le listează referințele TikTok, cu „Niciun câmp” acolo unde un endpoint nu documentează nimic pentru acea setare:

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

Ce permite contul?

GET /business/video/settings/ cu business_id returnează limitele contului pentru postările sale. Citiți-le înainte de publicare, deoarece TikTok acceptă doar valorile pe care le listează:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS și SELF_ONLY pentru un cont public; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS și SELF_ONLY pentru unul privat.
  • comment_disabled: true când contul nu primește comentarii de la nimeni, iar atunci disable_comment acceptă doar true.
  • duet_disabled și stitch_disabled: true când contul permite Duet sau Stitch doar pentru Only you sau este privat; comutatorul corespunzător acceptă atunci doar true.
  • max_video_post_duration_sec: cel mai lung video pe care contul îl poate publica; unul mai lung eșuează.
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
  }
}

Cine poate vedea postarea?

La o postare cu fotografii, privacy_level pe care îl trimiteți: PUBLIC_TO_EVERYONE pentru persoanele de pe TikTok sau din afara lui, MUTUAL_FOLLOW_FRIENDS pentru urmăritorii pe care contul îi urmărește la rândul lui, FOLLOWER_OF_CREATOR pentru urmăritorii unui cont privat, sau SELF_ONLY. Endpoint-ul de video nu are câmp de confidențialitate, pentru că publică postări video publice. O postare setată pe Friends sau Only you nu poate fi vizionată nici prin embed_url.

Cum funcționează comentariile, Duet și Stitch?

Fiecare este un comutator care dezactivează funcția când este setat pe true. disable_comment există la ambele endpoint-uri; disable_duet și disable_stitch există doar pentru videoclipuri. Toate au valoarea implicită false, ceea ce lasă funcția activă, în limitele setărilor de confidențialitate ale contului: un cont care nu primește comentarii de la nimeni sau care limitează Duet sau Stitch la Only you poate publica doar cu comutatorul setat pe true.

Cum se alege coperta?

Pentru un video, în două moduri. post_info.thumbnail_offset alege un cadru după momentul său în milisecunde, implicit 0, rotunjit în sus până la cel mai apropiat cadru; un moment după sfârșitul videoclipului trimite webhook-ul de eșec, iar videoclipul nu este publicat. custom_thumbnail_url, la nivelul superior al corpului, oferă în schimb o imagine și face ca TikTok să ignore offset-ul. La o postare cu fotografii, photo_cover_index alege una dintre imagini, numărând de la 0.

  • Imagine de copertă personalizată: JPG, JPEG, WebP sau PNG, de până la 20 MB.
  • Dimensiune: de la 360 x 360 pixeli până la 1080 x 1920, sau 1920 x 1080.
  • Locație: un domeniu sau un prefix de URL verificat pentru aplicație, ca și videoclipul în sine.

Ce înseamnă etichetele de brand?

Mențiuni pe care TikTok le afișează pe postare. is_brand_organic setat pe true o etichetează Promotional content, pentru postările care promovează propria afacere a contului. is_branded_content setat pe true o etichetează Paid partnership, pentru postările făcute într-un parteneriat plătit cu un brand, și are prioritate când ambele sunt true. La un video cu is_branded_content, tto_invite_link poate lega postarea de o campanie TikTok One Creator Marketplace la care contul s-a alăturat.

Ce alte opțiuni există în post_info?

Câteva în plus, fiecare documentată la endpoint-ul care o primește:

  • is_ai_generated, la videoclipuri: etichetează postarea cu Creator labeled as AI-generated, ceea ce nu poate fi schimbat odată publicată.
  • location_id cu location_name: o etichetă de locație găsită prin GET /business/publish/location/.
  • music_sound_info: un sunet comercial după ID; la videoclipuri și volumul său, de la 0 la 100, precum și începutul și sfârșitul în milisecunde.
  • auto_add_music, la postările cu fotografii: adaugă muzică recomandată, care poate fi schimbată ulterior în aplicația TikTok.
  • upload_to_draft sau is_draft: trimite postarea în inbox-ul creatorului ca ciornă, împreună cu videoclipul, cu scope-ul video.upload.
  • is_ads_only, la videoclipuri: publică o postare Only show in ads care rămâne în afara profilului.

Ce setări setează publish_tiktok_post?

Trei vin din cererea dumneavoastră: legenda, titlul unei postări cu fotografii și disable_comment. easyCoexistence trimite is_brand_organic și is_branded_content ca false, publică postările cu fotografii ca PUBLIC_TO_EVERYONE, cu prima imagine drept copertă, și lasă restul setărilor unui video în afara cererii, astfel încât se aplică valorile implicite ale TikTok: disable_duet și disable_stitch false, thumbnail_offset 0 și is_ai_generated false.

Cum trimiteți celelalte setări?

Din propriul cod, cu token-ul și business_id-ul contului din get_social_credentials, pe căile Business API de sub business/. Un GET la business/video/settings/ citește limitele contului. Un POST la business/video/publish/ sau business/photo/publish/ poate include corpul complet documentat, iar acesta ajunge la TikTok așa cum este scris, inclusiv URL-urile media, deci trebuie să se afle pe un domeniu sau pe un prefix de URL verificat pentru aplicație; publish_tiktok_post este apelul care trece linkul dumneavoastră prin ruta media verificată a 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>

Greșeli frecvente

  • Așteptarea ca privacy_level să funcționeze la un video. Endpoint-ul de video publică postări publice, iar referința sa nu listează niciun câmp de confidențialitate; postările cu fotografii primesc privacy_level.
  • Activarea comentariilor pentru un cont care nu primește niciunul. Când comment_disabled este true, TikTok acceptă disable_comment doar ca true.
  • Setarea thumbnail_offset după sfârșitul videoclipului. TikTok trimite webhook-ul de eșec, iar videoclipul nu este publicat.
  • Trimiterea PUBLIC_TO_EVERYONE pentru un cont privat. Lista sa privacy_level_options include în schimb FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS și SELF_ONLY.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 per număr conectat pe lună, scăzând până la US$ 0.75 pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Pot publica un videoclip TikTok privat prin API?

Nu cu endpoint-ul de video, care publică postări publice. Postările cu fotografii primesc privacy_level, inclusiv SELF_ONLY, iar un videoclip poate ajunge în inbox-ul creatorului ca ciornă, cu upload_to_draft.

Cum dezactivez Duet și Stitch prin API?

Setați post_info.disable_duet și post_info.disable_stitch pe true la /business/video/publish/. Când contul le limitează deja, TikTok acceptă doar true.

Pot adăuga o etichetă de locație prin API-ul TikTok?

Da. post_info primește location_id cu location_name, pentru o etichetă de locație găsită prin GET /business/publish/location/.

Care este diferența dintre is_brand_organic și is_branded_content?

is_brand_organic adaugă eticheta Promotional content pentru propria afacere a contului; is_branded_content adaugă eticheta Paid partnership și are prioritate când ambele sunt true.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la