Paramètres de publication TikTok via l'API : confidentialité, commentaires, Duet et Stitch
L'API for Business de TikTok accepte les paramètres d'une publication dans l'appel de publication, surtout dans post_info. Les vidéos prennent disable_comment, disable_duet et disable_stitch, une couverture issue de thumbnail_offset ou custom_thumbnail_url, les étiquettes is_brand_organic et is_branded_content, et is_ai_generated. Les publications photo prennent privacy_level, disable_comment, les mêmes étiquettes de marque et auto_add_music. GET /business/video/settings/ renvoie les valeurs autorisées par compte.
easyCoexistence publie des vidéos et des publications photo TikTok avec publish_tiktok_post depuis Claude, ChatGPT ou votre propre code, avec la légende, le titre d'une publication photo et les commentaires activés ou désactivés, et get_social_credentials donne à votre propre code le token pour lire les paramètres autorisés du compte.
Options de confidentialité pour les publications photo d'un compte public : PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS et SELF_ONLY.
Niveau de confidentialité attribué à un compte privé à la place de PUBLIC_TO_EVERYONE : visible par ses abonnés uniquement.
Valeur par défaut de disable_comment, disable_duet et disable_stitch : commentaires, Duet et Stitch restent activés, sauf réglage contraire.
Taille maximale d'une image de couverture personnalisée pour une vidéo : au moins 360 x 360 pixels et jusqu'à 20 Mo.
L'étiquette is_branded_content s'applique ; elle prime lorsque is_brand_organic est également vrai.
Champ obligatoire du post_info d'une publication photo, limité aux options renvoyées par GET /business/video/settings/ pour le compte.
Quels paramètres prend chaque endpoint de publication ?
/business/video/publish/ et /business/photo/publish/ partagent certains paramètres et en diffèrent sur d'autres. La plupart se trouvent dans post_info, tandis que custom_thumbnail_url et photo_cover_index sont au premier niveau du corps de la requête. Côte à côte, tels que les listent les références de TikTok, avec Aucun champ là où un endpoint ne documente rien pour ce paramètre :
| 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 |
Qu'autorise le compte ?
GET /business/video/settings/ avec business_id renvoie les limites du compte sur ses publications. Consultez-le avant de publier, car TikTok n'accepte que les valeurs qu'elle énumère :
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSetSELF_ONLYpour un compte public ;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSetSELF_ONLYpour un compte privé.comment_disabled: true lorsque le compte n'accepte de commentaires de personne ;disable_commentn'accepte alors que true.duet_disabledetstitch_disabled: true lorsque le compte autorise Duet ou Stitch uniquement à « Vous seul », ou lorsqu'il est privé ; l'interrupteur correspondant n'accepte alors que true.max_video_post_duration_sec: la vidéo la plus longue que le compte peut publier ; une vidéo plus longue échoue.
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
}
}Qui peut voir la publication ?
Sur une publication photo, le privacy_level que vous envoyez : PUBLIC_TO_EVERYONE pour les personnes sur TikTok ou non, MUTUAL_FOLLOW_FRIENDS pour les abonnés que le compte suit en retour, FOLLOWER_OF_CREATOR pour les abonnés d'un compte privé, ou SELF_ONLY. L'endpoint vidéo n'a pas de champ de confidentialité, puisqu'il publie des vidéos publiques. Une publication réglée sur « Amis » ou « Vous seul » ne peut pas non plus être regardée via son embed_url.
Comment fonctionnent les commentaires, Duet et Stitch ?
Chacun est un interrupteur qui désactive la fonctionnalité lorsqu'il est réglé sur true. disable_comment existe sur les deux endpoints ; disable_duet et disable_stitch n'existent que sur les vidéos. Tous sont à false par défaut, ce qui laisse la fonctionnalité active dans les limites des paramètres de confidentialité du compte : un compte qui n'accepte de commentaires de personne, ou qui limite Duet ou Stitch à « Vous seul », ne peut publier qu'avec cet interrupteur réglé sur true.
Comment la couverture est-elle choisie ?
Sur une vidéo, de deux façons. post_info.thumbnail_offset choisit une image par son temps en millisecondes, 0 par défaut, arrondi à l'image la plus proche ; un temps au-delà de la fin de la vidéo envoie un webhook d'échec et la vidéo n'est pas publiée. custom_thumbnail_url, au premier niveau du corps, fournit à la place une image et fait ignorer le décalage à TikTok. Sur une publication photo, photo_cover_index choisit l'une des images, en comptant à partir de 0.
- Image de couverture personnalisée : JPG, JPEG, WebP ou PNG, jusqu'à 20 Mo.
- Taille : de 360 x 360 pixels jusqu'à 1080 x 1920, ou 1920 x 1080.
- Emplacement : un domaine ou un préfixe d'URL vérifié pour l'application, comme la vidéo elle-même.
Que signifient les étiquettes de marque ?
Mentions affichées par TikTok sur la publication. Réglé sur true, is_brand_organic applique l'étiquette Contenu promotionnel, pour les publications qui font la promotion de l'entreprise du compte. Réglé sur true, is_branded_content applique l'étiquette Partenariat rémunéré, pour les publications réalisées dans le cadre d'un partenariat payant avec une marque ; il prévaut lorsque les deux sont à true. Sur une vidéo avec is_branded_content, tto_invite_link peut relier la publication à une campagne du TikTok One Creator Marketplace à laquelle le compte a adhéré.
Quelles autres options figurent dans post_info ?
Quelques autres, chacune documentée sur l'endpoint qui la prend :
is_ai_generated, vidéos : étiquette la publication « Créé par le créateur, généré par IA », libellé qui ne peut plus être modifié une fois la publication faite.location_idaveclocation_name: une balise de lieu trouvée via GET /business/publish/location/.music_sound_info: un son commercial par ID ; sur les vidéos, aussi son volume, de 0 à 100, et son début et sa fin en millisecondes.auto_add_music, publications photo : ajoute de la musique recommandée, modifiable plus tard dans l'application TikTok.upload_to_draftouis_draft: envoie la publication dans la boîte de réception du créateur comme brouillon, avec la vidéo, avec le scope video.upload.is_ads_only, vidéos : publie une publication « Visible uniquement dans les publicités » qui reste hors du profil.
Quels paramètres publish_tiktok_post définit-il ?
Trois proviennent de votre requête : la légende, le titre d'une publication photo et disable_comment. easyCoexistence envoie is_brand_organic et is_branded_content à false, publie les publications photo en PUBLIC_TO_EVERYONE avec la première image comme couverture, et omet le reste des paramètres d'une vidéo, de sorte que les valeurs par défaut de TikTok s'appliquent : disable_duet et disable_stitch à false, thumbnail_offset à 0 et is_ai_generated à false.
Comment envoyer les autres paramètres ?
Depuis votre propre code, avec le token et le business_id du compte fournis par get_social_credentials, sur les chemins de la Business API sous business/. Un GET sur business/video/settings/ lit les limites du compte. Un POST sur business/video/publish/ ou business/photo/publish/ peut porter le corps complet documenté, et il atteint TikTok tel quel, URL des médias comprises ; celles-ci doivent donc se trouver sur un domaine ou un préfixe d'URL vérifié pour l'application. publish_tiktok_post est l'appel qui achemine votre lien par la route média vérifiée d'easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Erreurs courantes
- Attendre que privacy_level fonctionne sur une vidéo. L'endpoint vidéo publie des publications publiques et sa référence ne liste aucun champ de confidentialité ; les publications photo prennent privacy_level.
- Activer les commentaires pour un compte qui n'en accepte aucun. Lorsque comment_disabled vaut true, TikTok n'accepte disable_comment que sur true.
- Régler thumbnail_offset au-delà de la fin de la vidéo. TikTok envoie un webhook d'échec et la vidéo n'est pas publiée.
- Envoyer PUBLIC_TO_EVERYONE pour un compte privé. Sa liste privacy_level_options contient à la place FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS et SELF_ONLY.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Puis-je publier une vidéo TikTok privée via l'API ?
Pas avec l'endpoint vidéo, qui publie des publications publiques. Les publications photo prennent privacy_level, SELF_ONLY compris, et une vidéo peut être envoyée dans la boîte de réception du créateur comme brouillon avec upload_to_draft.
Comment désactiver Duet et Stitch via l'API ?
Réglez post_info.disable_duet et post_info.disable_stitch sur true dans /business/video/publish/. Lorsque le compte les limite déjà, TikTok n'accepte que true.
Puis-je ajouter une balise de lieu via l'API TikTok ?
Oui. post_info accepte location_id avec location_name, pour une balise de lieu trouvée via GET /business/publish/location/.
Quelle est la différence entre is_brand_organic et is_branded_content ?
is_brand_organic ajoute l'étiquette Contenu promotionnel pour l'entreprise du compte ; is_branded_content ajoute l'étiquette Partenariat rémunéré et prévaut lorsque les deux sont à true.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le