Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Ajouter de la musique aux publications TikTok via l'API

L'API for Business de TikTok ajoute de la musique depuis sa Commercial Music Library : post_info.music_sound_info accepte le music_sound_id d'un titre sur les publications vidéo et photo, et sur les vidéos aussi le volume du titre, son début et sa fin en millisecondes, ainsi que le volume du son d'origine de la vidéo. Les publications photo peuvent aussi utiliser auto_add_music pour une musique recommandée. Les ID des titres proviennent de GET /discovery/cml/trending_list/.

easyCoexistence publie des vidéos et publications photo TikTok avec publish_tiktok_post depuis Claude, ChatGPT ou votre propre code, immédiatement ou à une heure fixée jusqu'à 90 jours à l'avance, et une vidéo part avec la bande-son mixée dans son fichier.

100

Titres les plus populaires renvoyés par /discovery/cml/trending_list/, tous pré-validés pour le contenu organique et la création de publicités.

0 to 100

Plage de music_sound_volume et video_original_sound_volume ; via l'API, les deux valent 0 par défaut, alors que l'application TikTok démarre à 50.

1 million

Titres de la Commercial Music Library de TikTok, la bibliothèque mondiale pré-validée que les entreprises utilisent pour leur activité commerciale sur TikTok.

TikTok only

Lieux où les créations utilisant la musique de la liste musicale publicitaire de TikTok peuvent être diffusées, sauf autorisation distincte des ayants droit.

DIRECT_POST

Seul post_mode pour lequel l'endpoint photo de la Content Posting API applique auto_add_music, selon developers.tiktok.com.

Quels champs musicaux les endpoints de publication de TikTok acceptent-ils ?

Les deux endpoints transportent la musique dans post_info, sous music_sound_info, et désignent un titre par son ID de la Commercial Music Library. Au-delà de cela, ils diffèrent : l'endpoint vidéo ajoute des commandes de mixage, et l'endpoint photo ajoute une option qui laisse TikTok choisir la musique. Côte à côte, tels que les références de TikTok les listent :

Video postPhoto post
The trackmusic_sound_info.music_sound_idmusic_sound_info.music_sound_id
Track volumemusic_sound_volume, 0 to 100, required with a trackNo field
Part of the trackmusic_sound_start and music_sound_end, in millisecondsNo field
The video's own soundvideo_original_sound_volume, 0 to 100Not applicable
Recommended musicNo fieldauto_add_music, false by default
As a draftupload_to_draft drops the rest of post_infois_draft keeps only the title and caption

Comment ajouter un titre à une vidéo ?

Envoyez music_sound_info dans post_info sur POST /business/video/publish/. Une fois cet objet présent, music_sound_id et music_sound_volume sont obligatoires. music_sound_start et music_sound_end choisissent la partie du titre en millisecondes, du début du titre à la durée complète de la vidéo par défaut ; ainsi, une vidéo de 2 secondes prend les 2 000 premières millisecondes du titre. Renseignez aussi video_original_sound_volume dès que le son d'origine de la vidéo compte, car il vaut 0 par défaut :

A 15-second video with seconds 15 to 30 of a library track
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new blend is here #coffee",
      "is_brand_organic": false,
      "is_branded_content": false,
      "music_sound_info": {
        "music_sound_id": "<SONG_CLIP_ID>",
        "music_sound_volume": 40,
        "music_sound_start": 15000,
        "music_sound_end": 30000,
        "video_original_sound_volume": 80
      }
    }
  }'

D'où viennent les ID des titres ?

De GET /discovery/cml/trending_list/, un endpoint de la Discovery API qui prend le token d'accès d'un compte TikTok et business_id, là où les endpoints hashtag de Discovery prennent celui d'un annonceur ; la référence de TikTok le range sous la permission Discovery de Creative Management. Il renvoie jusqu'à 100 titres populaires, chacun avec son nom, son artiste, sa durée, son rang, ses genres, un preview_url qui n'expire pas et jusqu'à 30 jours de trending_history. full_duration_song_clip et trending_song_clip contiennent chacun un song_clip_id, la valeur que TikTok nomme music_sound_id :

  • genre : ALL par défaut, ou l'une de plus de 100 valeurs comme POP, LATIN, LO-FI ou SERTANEJO.
  • country_code : US par défaut. date_range : 1DAY, 7DAY par défaut, 30DAY ou 90DAY.
  • /discovery/cml/video_list/ : les 20 vidéos tendance qui utilisent un titre, selon son commercial_music_id et un country_code.
Popular pop tracks in Brazil over the last 7 days
curl -G 'https://business-api.tiktok.com/open_api/v1.3/discovery/cml/trending_list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'genre=POP' \
  --data-urlencode 'country_code=BR' \
  --data-urlencode 'date_range=7DAY'

Comment les publications photo reçoivent-elles de la musique ?

De deux façons sur POST /business/photo/publish/. auto_add_music réglé sur true demande à TikTok d'ajouter une musique recommandée, que le propriétaire peut modifier plus tard dans l'application TikTok ; music_sound_info.music_sound_id désigne un titre précis de la bibliothèque, sans champs de volume, de début ni de fin pour les photos. Sur developers.tiktok.com, l'endpoint photo de la Content Posting API a son propre auto_add_music, appliqué seulement lorsque post_mode vaut DIRECT_POST, et son endpoint de publication directe de vidéo ne documente aucun champ musical.

Que signifie la Commercial Music Library pour les comptes Business ?

C'est la musique qu'ils ont le droit d'utiliser. Le centre d'aide Business de TikTok décrit la bibliothèque comme une collection mondiale pré-validée de 1 million de titres, indique que les entreprises ne peuvent pas utiliser la bibliothèque musicale générale à des fins commerciales, et les oriente vers la Commercial Music Library pour le contenu organique, les duos, les reacts et les stitches inclus, les publicités vidéo et le contenu de marque. Sur un Business Account, « Ajouter un son » dans l'application n'affiche que les sons de la bibliothèque, et l'API trace la même limite, puisque music_sound_id prend un ID de la bibliothèque.

Que ne peut pas faire l'API avec la musique ?

Quelques éléments échappent à ses champs, tels que les références de TikTok les décrivent :

  • Nommer un son de la bibliothèque générale de TikTok : music_sound_id prend un ID de la Commercial Music Library.
  • Chercher la bibliothèque par titre : /discovery/cml/trending_list/ filtre les titres populaires par genre, pays et période.
  • Conserver la musique sur un brouillon : upload_to_draft fait ignorer par TikTok le reste de post_info, et is_draft ne conserve que le titre et la légende.
  • Utiliser votre propre titre dans une publication organique : /file/music/upload/ ajoute de la musique pour les créations publicitaires sous un advertiser_id, et l'avis de TikTok à cet endroit laisse la responsabilité du droit d'auteur à celui qui téléverse.

Quels sont les contournements ?

Il y en a trois, chacun fondé sur ce que les références de TikTok documentent, plus un risque à peser :

  • Mixer la musique dans le fichier. Les contraintes de TikTok décrivent la vidéo comme un contenu audio-vidéo ; un son mixé part donc avec elle. Utilisez un audio dont vous détenez les droits.
  • Envoyer un brouillon. Avec upload_to_draft ou is_draft et le scope video.upload, la publication arrive dans la boîte de réception TikTok du créateur, à modifier et publier dans l'application.
  • Laisser TikTok choisir sur les publications photo. auto_add_music ajoute une musique recommandée, que le propriétaire peut remplacer plus tard dans l'application TikTok.
  • Le risque avec l'audio mixé : la liste des publications de TikTok cite les violations de droits musicaux parmi les raisons probables de filtrage d'une publication.

Comment savoir si un son a généré des vues ?

Grâce à impression_sources, un champ de /business/video/list/ qui classe d'où viennent les spectateurs d'une publication ; l'une de ses valeurs est Sound, pour les vues venues des pages de sons. Il requiert le scope video.insights et, comme les autres compteurs, arrive avec 24 à 48 heures de retard. Via easyCoexistence, get_social_insights le renvoie pour l'une des 20 publications les plus récentes du compte lorsque impression_sources figure dans metrics, avec l'item_id de la publication comme object_id.

Que fait easyCoexistence avec la musique ?

Il publie le son déjà présent dans votre fichier. publish_tiktok_post, immédiatement ou avec scheduled_at, envoie la légende, le titre d'une publication photo et le réglage des commentaires, sans music_sound_info ni auto_add_music ; ainsi une vidéo conserve sa propre bande-son et une publication photo part sans musique. Votre propre code peut faire un POST vers business/video/publish/ avec music_sound_info et le token de get_social_credentials, mais ce corps part vers TikTok tel quel, video_url compris, et TikTok ne récupère les médias que depuis les domaines ou préfixes d'URL vérifiés pour l'application. Les chemins /discovery/ attendent le token d'un annonceur, donc la liste des titres échappe au token du compte.

Erreurs courantes

  • Oublier video_original_sound_volume en ajoutant un titre. Via l'API, il vaut 0 par défaut, alors que l'application TikTok démarre les deux sons à 50 ; réglez-le donc dès que le son d'origine de la vidéo compte.
  • Passer le nom ou le preview_url d'un titre comme music_sound_id. La référence des titres de TikTok désigne song_clip_id, issu de full_duration_song_clip ou trending_song_clip, comme la valeur à transmettre.
  • Appeler /discovery/cml/trending_list/ avec un token d'annonceur. Les endpoints de titres prennent le token d'un compte TikTok et business_id, comme l'Accounts API.
  • Prendre une durée de 0 pour un titre cassé. TikTok précise qu'un titre qui n'est qu'un extrait d'une pièce plus longue peut afficher 0 ; vérifiez donc son aperçu avant de choisir début et fin.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Peut-on ajouter n'importe quelle chanson à une publication TikTok via l'API ?

Des titres de la Commercial Music Library, par ID. La musique déjà mixée dans un fichier vidéo part avec ce fichier, elle doit donc être une musique dont vous avez le droit d'usage.

Quel volume l'API de TikTok règle-t-elle pour la musique ajoutée ?

0 par défaut. music_sound_volume et video_original_sound_volume vont de 0 à 100 et valent tous deux 0 via l'API, alors que l'application TikTok démarre à 50 ; réglez-les donc sur chaque vidéo avec un titre.

La musique d'une publication compte-t-elle si elle sert ensuite dans une publicité ?

Oui, TikTok la vérifie : /identity/music/authorization/ indique, pour les lieux et dates de diffusion de la publicité, si la musique de la publication est entièrement autorisée, sans autorisation ou sans ID de titre.

Combien de titres compte la Commercial Music Library de TikTok ?

1 million, selon le centre d'aide Business de TikTok, tous pré-validés pour un usage commercial. /discovery/cml/trending_list/ en renvoie jusqu'à 100 populaires à la fois.

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