AccediInizia la prova gratuita
easyCoexistence API ufficiali

Impostazioni dei post TikTok via API: privacy, commenti, Duet e Stitch

L'API for Business di TikTok accetta le impostazioni di un post nella chiamata di pubblicazione, per lo più dentro post_info. I video accettano disable_comment, disable_duet e disable_stitch, una copertina da thumbnail_offset o custom_thumbnail_url, e le etichette is_brand_organic, is_branded_content e is_ai_generated. I post di foto accettano privacy_level, disable_comment, le stesse etichette di marca e auto_add_music. GET /business/video/settings/ restituisce i valori che ogni account consente.

easyCoexistence pubblica video TikTok e post di foto con publish_tiktok_post da Claude, ChatGPT o dal tuo codice, con didascalia, titolo di un post di foto e commenti attivi o disattivati, e get_social_credentials fornisce al tuo codice il token per leggere le impostazioni consentite dell'account.

3 levels

Opzioni di privacy per i post di foto di un account pubblico: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.

FOLLOWER_OF_CREATOR

Livello di privacy che un account privato riceve al posto di PUBLIC_TO_EVERYONE: visibile solo ai suoi follower.

false

Valore predefinito di disable_comment, disable_duet e disable_stitch: commenti, Duet e Stitch restano attivi se non impostati diversamente.

1080 x 1920

Copertina personalizzata più grande per un video: deve misurare almeno 360 x 360 pixel e arrivare fino a 20 MB.

Paid partnership

L'etichetta collegata a is_branded_content prevale anche quando is_brand_organic è true.

privacy_level

Campo obbligatorio di post_info di un post di foto, limitato alle opzioni che GET /business/video/settings/ restituisce per l'account.

Quali impostazioni accetta ogni endpoint di pubblicazione?

/business/video/publish/ e /business/photo/publish/ condividono alcune impostazioni e ne differiscono su altre. La maggior parte sta dentro post_info, mentre custom_thumbnail_url e photo_cover_index stanno al primo livello del body. Qui affiancate, come le elencano i riferimenti di TikTok, con Nessun campo dove un endpoint non documenta nulla per quell'impostazione:

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

Che cosa consente l'account?

GET /business/video/settings/ con business_id restituisce i limiti che l'account ha sui suoi post. Leggilo prima di pubblicare, perché TikTok accetta solo i valori che elenca:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY per un account pubblico; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY per uno privato.
  • comment_disabled: true quando l'account non accetta commenti da nessuno; in quel caso disable_comment accetta solo true.
  • duet_disabled e stitch_disabled: true quando l'account consente Duet o Stitch solo a 'Solo tu', oppure è privato; l'interruttore corrispondente accetta allora solo true.
  • max_video_post_duration_sec: la durata massima del video che l'account può pubblicare; un video più lungo non riesce.
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
  }
}

Chi può vedere il post?

Su un post di foto, il privacy_level che invii: PUBLIC_TO_EVERYONE per le persone dentro o fuori da TikTok, MUTUAL_FOLLOW_FRIENDS per i follower che l'account ricambia, FOLLOWER_OF_CREATOR per i follower di un account privato, oppure SELF_ONLY. L'endpoint video non ha un campo privacy, perché pubblica post video pubblici. Un post impostato su 'Amici' o 'Solo tu' non si può guardare nemmeno tramite il suo embed_url.

Come funzionano commenti, Duet e Stitch?

Ciascuno è un interruttore che, impostato su true, disattiva la funzione. disable_comment esiste su entrambi gli endpoint; disable_duet e disable_stitch esistono solo sui video. Tutti hanno come predefinito false, che lascia la funzione attiva entro ciò che consentono le impostazioni di privacy dell'account: un account che non accetta commenti da nessuno, o che limita Duet o Stitch a 'Solo tu', può pubblicare solo con l'interruttore impostato su true.

Come si sceglie la copertina?

Su un video, in due modi. post_info.thumbnail_offset sceglie un fotogramma tramite il suo tempo in millisecondi, 0 di default, arrotondato al fotogramma più vicino; un tempo oltre la fine del video invia un webhook di errore e il video non viene pubblicato. custom_thumbnail_url, al primo livello del body, fornisce invece un'immagine e fa ignorare a TikTok l'offset. Su un post di foto, photo_cover_index sceglie una delle immagini, contando da 0.

  • Immagine di copertina personalizzata: JPG, JPEG, WebP o PNG, fino a 20 MB.
  • Dimensioni: da 360 x 360 pixel fino a 1080 x 1920, oppure 1920 x 1080.
  • Posizione: un dominio o un prefisso URL verificato per l'app, come il video stesso.

Che cosa significano le etichette di marca?

Sono avvisi che TikTok mostra sul post. is_brand_organic impostato su true etichetta il post come 'Promotional content', per i post che promuovono l'azienda stessa dell'account. is_branded_content impostato su true lo etichetta come 'Paid partnership', per i post realizzati in una collaborazione a pagamento con un marchio, e prevale quando entrambi sono true. Su un video con is_branded_content, tto_invite_link può collegare il post a una campagna del TikTok One Creator Marketplace a cui l'account ha aderito.

Quali altre opzioni ci sono in post_info?

Alcune altre, ciascuna documentata nell'endpoint che la accetta:

  • is_ai_generated, video: etichetta il post come 'Creator labeled as AI-generated', e non si può più cambiare dopo la pubblicazione.
  • location_id con location_name: un tag di posizione trovato tramite GET /business/publish/location/.
  • music_sound_info: un suono commerciale per ID; sui video anche il suo volume, da 0 a 100, e il suo inizio e fine in millisecondi.
  • auto_add_music, post di foto: aggiunge musica consigliata, che si può cambiare in seguito nell'app TikTok.
  • upload_to_draft oppure is_draft: invia il post alla casella del creator come bozza, insieme al video, con lo scope video.upload.
  • is_ads_only, video: pubblica un post 'Only show in ads' che non compare sul profilo.

Quali impostazioni imposta publish_tiktok_post?

Tre arrivano dalla tua richiesta: la didascalia, il titolo di un post di foto e disable_comment. easyCoexistence invia is_brand_organic e is_branded_content come false, pubblica i post di foto come PUBLIC_TO_EVERYONE con la prima immagine come copertina, e lascia fuori il resto delle impostazioni di un video, così si applicano i valori predefiniti di TikTok: disable_duet e disable_stitch false, thumbnail_offset 0 e is_ai_generated false.

Come si inviano le altre impostazioni?

Dal tuo codice, con il token e il business_id dell'account di get_social_credentials, sui percorsi Business API sotto business/. Una GET a business/video/settings/ legge i limiti dell'account. Una POST a business/video/publish/ o business/photo/publish/ può contenere il body completo documentato, e arriva a TikTok così com'è, URL dei media compresi, quindi devono trovarsi su un dominio o prefisso URL verificato per l'app; publish_tiktok_post è la chiamata che instrada il tuo link tramite la rotta multimediale verificata di 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>

Errori comuni

  • Aspettarsi che privacy_level funzioni su un video. L'endpoint video pubblica post pubblici e il suo riferimento non elenca alcun campo privacy; i post di foto accettano privacy_level.
  • Attivare i commenti per un account che non ne accetta nessuno. Quando comment_disabled è true, TikTok accetta disable_comment solo come true.
  • Impostare thumbnail_offset oltre la fine del video. TikTok invia un webhook di errore e il video non viene pubblicato.
  • Inviare PUBLIC_TO_EVERYONE per un account privato. Il suo privacy_level_options elenca invece FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e con una prova gratuita di 3 giorni.

Domande frequenti

Posso pubblicare un video TikTok privato tramite API?

Non con l'endpoint video, che pubblica post pubblici. I post di foto accettano privacy_level, anche SELF_ONLY, e un video può andare nella casella del creator come bozza con upload_to_draft.

Come disattivo Duet e Stitch tramite API?

Imposta post_info.disable_duet e post_info.disable_stitch su true in /business/video/publish/. Quando l'account li limita già, TikTok accetta solo true.

Posso aggiungere un tag di posizione tramite l'API di TikTok?

Sì. post_info accetta location_id con location_name, per un tag di posizione trovato tramite GET /business/publish/location/.

Qual è la differenza tra is_brand_organic e is_branded_content?

is_brand_organic aggiunge l'etichetta Promotional content per l'azienda dell'account; is_branded_content aggiunge l'etichetta Paid partnership e prevale quando entrambi sono true.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il