Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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.

3 levels

Options de confidentialité pour les publications photo d'un compte public : PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS et SELF_ONLY.

FOLLOWER_OF_CREATOR

Niveau de confidentialité attribué à un compte privé à la place de PUBLIC_TO_EVERYONE : visible par ses abonnés uniquement.

false

Valeur par défaut de disable_comment, disable_duet et disable_stitch : commentaires, Duet et Stitch restent activés, sauf réglage contraire.

1080 x 1920

Taille maximale d'une image de couverture personnalisée pour une vidéo : au moins 360 x 360 pixels et jusqu'à 20 Mo.

Paid partnership

L'étiquette is_branded_content s'applique ; elle prime lorsque is_brand_organic est également vrai.

privacy_level

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 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

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_FRIENDS et SELF_ONLY pour un compte public ; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS et SELF_ONLY pour un compte privé.
  • comment_disabled : true lorsque le compte n'accepte de commentaires de personne ; disable_comment n'accepte alors que true.
  • duet_disabled et stitch_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.
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
  }
}

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_id avec location_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_draft ou is_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.

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>

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.
Faire cela avec EasyCoexistence

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