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.
Opzioni di privacy per i post di foto di un account pubblico: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS e SELF_ONLY.
Livello di privacy che un account privato riceve al posto di PUBLIC_TO_EVERYONE: visibile solo ai suoi follower.
Valore predefinito di disable_comment, disable_duet e disable_stitch: commenti, Duet e Stitch restano attivi se non impostati diversamente.
Copertina personalizzata più grande per un video: deve misurare almeno 360 x 360 pixel e arrivare fino a 20 MB.
L'etichetta collegata a is_branded_content prevale anche quando is_brand_organic è true.
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 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 |
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_FRIENDSeSELF_ONLYper un account pubblico;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSeSELF_ONLYper uno privato.comment_disabled: true quando l'account non accetta commenti da nessuno; in quel casodisable_commentaccetta solo true.duet_disabledestitch_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.
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_idconlocation_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_draftoppureis_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.
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.
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