Muziek toevoegen aan TikTok-posts via de API
De API for Business van TikTok voegt muziek toe uit de Commercial Music Library: post_info.music_sound_info neemt bij video- en fotoposts het music_sound_id van een nummer, en bij video's ook het volume van het nummer, het begin en einde in milliseconden en het volume van het eigen geluid van de video. Fotoposts kunnen daarnaast auto_add_music gebruiken voor aanbevolen muziek. De nummer-ID's haal je op via GET /discovery/cml/trending_list/.
easyCoexistence publiceert TikTok-video's en fotoposts met publish_tiktok_post vanuit Claude, ChatGPT of je eigen code, direct of op een ingesteld moment tot 90 dagen vooruit, en een video gaat de deur uit met de soundtrack in het bestand gemengd.
Meest populaire nummers die /discovery/cml/trending_list/ teruggeeft, allemaal vooraf goedgekeurd voor organische content en advertentiecreaties.
Bereik van music_sound_volume en video_original_sound_volume; via de API staan beide standaard op 0, terwijl de TikTok-app op 50 begint.
Nummers in de Commercial Music Library van TikTok, de wereldwijde bibliotheek met vooraf goedgekeurde muziek die bedrijven gebruiken voor commerciële activiteiten op TikTok.
Waar creatives met muziek uit de muzieklijst voor advertenties van TikTok getoond kunnen worden, tenzij de rechthebbenden afzonderlijk toestemming geven.
De enige post_mode waarin het fotoendpoint van de Content Posting API auto_add_music toepast, op developers.tiktok.com.
Welke muziekvelden accepteren de publicatie-endpoints van TikTok?
Beide endpoints plaatsen muziek in post_info, onder music_sound_info, en noemen een nummer met zijn ID uit de Commercial Music Library. Verder verschillen ze: het videoendpoint voegt mengopties toe, en het fotoendpoint een schakelaar waarmee TikTok de muziek kan kiezen. Naast elkaar, zoals TikTok ze in de referenties vermeldt:
| Video post | Photo post | |
|---|---|---|
| The track | music_sound_info.music_sound_id | music_sound_info.music_sound_id |
| Track volume | music_sound_volume, 0 to 100, required with a track | No field |
| Part of the track | music_sound_start and music_sound_end, in milliseconds | No field |
| The video's own sound | video_original_sound_volume, 0 to 100 | Not applicable |
| Recommended music | No field | auto_add_music, false by default |
| As a draft | upload_to_draft drops the rest of post_info | is_draft keeps only the title and caption |
Hoe voeg je een nummer aan een video toe?
Stuur music_sound_info binnen post_info naar POST /business/video/publish/. Zodra het object er is, zijn music_sound_id en music_sound_volume verplicht. music_sound_start en music_sound_end kiezen het deel van het nummer in milliseconden, standaard van het begin van het nummer tot de volledige lengte van de video, dus een video van 2 seconden neemt de eerste 2.000 milliseconden van het nummer. Stel ook video_original_sound_volume in wanneer het eigen geluid van de video belangrijk is, want die staat standaard op 0:
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
}
}
}'Waar komen de nummer-ID's vandaan?
Uit GET /discovery/cml/trending_list/, een Discovery API-endpoint dat een access token van een TikTok-account en business_id vraagt, waar de Discovery-hashtagendpoints die van een adverteerder vragen. TikTok's referentie plaatst het onder de Discovery-machtiging van Creative Management. Het geeft tot 100 populaire nummers terug, elk met naam, artiest, duur, rang, genres, een preview_url die niet verloopt en tot 30 dagen trending_history. full_duration_song_clip en trending_song_clip bevatten elk een song_clip_id, de waarde die TikTok music_sound_id noemt:
- genre: standaard ALL, of een van meer dan 100 waarden zoals POP, LATIN, LO-FI of SERTANEJO.
country_code: standaard US.date_range: 1DAY, standaard 7DAY, 30DAY of 90DAY.- /discovery/cml/
video_list/: de top 20 trending video's die een nummer gebruiken, op basis vancommercial_music_iden eencountry_code.
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'Hoe krijgen fotoposts muziek?
Op twee manieren via POST /business/photo/publish/. auto_add_music op true zetten laat TikTok aanbevolen muziek toevoegen, die de eigenaar later in de TikTok-app kan wijzigen. music_sound_info.music_sound_id noemt een specifiek nummer uit de bibliotheek, zonder volume-, begin- of eindvelden bij foto's. Op developers.tiktok.com heeft het fotoendpoint van de Content Posting API een eigen auto_add_music, die alleen wordt toegepast als post_mode DIRECT_POST is, en het directe videoendpoint documenteert geen muziekveld.
Wat betekent de Commercial Music Library voor zakelijke accounts?
Het is de muziek die ze mogen gebruiken. Het Business Help Center van TikTok beschrijft de bibliotheek als een vooraf goedgekeurde wereldwijde collectie van 1 miljoen nummers, zegt dat bedrijven de algemene muziekbibliotheek niet voor commercieel gebruik mogen gebruiken, en verwijst ze naar de Commercial Music Library voor organische content, duetten, reacts en stitches inbegrepen, video-advertenties en merkcontent. Op een Business Account toont Geluid toevoegen in de app alleen geluiden uit de bibliotheek, en de API trekt dezelfde grens, want music_sound_id vraagt om een bibliotheek-ID.
Wat kan de API niet met muziek?
Een paar dingen liggen buiten de velden, zoals TikTok's referenties ze beschrijven:
- Een geluid uit de algemene bibliotheek van TikTok noemen:
music_sound_idvraagt om een ID uit de Commercial Music Library. - De bibliotheek op titel doorzoeken: /discovery/cml/
trending_list/ filtert populaire nummers op genre, land en periode. - Muziek op een concept houden:
upload_to_draftzorgt dat TikTok de rest vanpost_infonegeert, enis_draftbehoudt alleen de titel en het bijschrift. - Je eigen nummer gebruiken in een organische post: /file/music/upload/ voegt muziek toe voor advertentiecreatives onder een
advertiser_id, en de melding van TikTok daar legt de verantwoordelijkheid voor auteursrechten bij de uploader.
Wat zijn de omwegen?
Drie, elk gebaseerd op wat TikTok's referenties documenteren, plus één risico om af te wegen:
- Meng de muziek in het bestand. TikTok's beperkingen beschrijven de video als audiovisuele content, dus een ingemengde soundtrack gaat ermee mee; gebruik audio waarvoor je de rechten hebt.
- Stuur een concept. Met
upload_to_draftofis_draften de video.upload-scope komt de post in de TikTok-inbox van de maker, om in de app te bewerken en te plaatsen. - Laat TikTok kiezen bij fotoposts.
auto_add_musicvoegt aanbevolen muziek toe, en de eigenaar kan die later in de TikTok-app vervangen. - Het risico bij ingemengd geluid: de referentie van TikTok voor postlijsten noemt schendingen van muziekauteursrechten als een van de waarschijnlijke redenen waarom een post wordt gefilterd.
Hoe zie je of een geluid views heeft opgeleverd?
Via impression_sources, een veld van /business/video/list/ dat rangschikt waar de kijkers van een post hun vonden; een van de waarden is Sound, voor views die via geluidspagina's binnenkwamen. Het vereist de video.insights-scope en komt, zoals de andere tellingen, 24 tot 48 uur later binnen. Via easyCoexistence geeft get_social_insights dit terug voor een van de 20 meest recente posts van het account wanneer impression_sources in metrics is opgegeven, met het item_id van de post als object_id.
Wat doet easyCoexistence met muziek?
Het publiceert het geluid dat al in je bestand zit. publish_tiktok_post, direct of met scheduled_at, stuurt het bijschrift, de titel van een fotopost en de instelling voor reacties, zonder music_sound_info en zonder auto_add_music, zodat een video zijn eigen soundtrack behoudt en een fotopost zonder muziek wordt geplaatst. Je eigen code kan een POST sturen naar business/video/publish/ met music_sound_info en het token uit get_social_credentials, maar die body gaat zoals geschreven naar TikTok, inclusief video_url, en TikTok haalt media alleen op van domeinen of URL-prefixen die voor de app zijn geverifieerd. /discovery/-paden vragen het token van een adverteerder, dus de nummerlijst ligt buiten bereik van het token van het account.
Veelgemaakte fouten
- video_original_sound_volume weglaten bij het toevoegen van een nummer. Via de API staat die standaard op 0, terwijl de TikTok-app beide geluiden op 50 begint, dus stel die in wanneer het eigen geluid van de video belangrijk is.
- De naam of preview_url van een nummer als music_sound_id doorgeven. De referentie van TikTok noemt song_clip_id, uit full_duration_song_clip of trending_song_clip, als de waarde om door te geven.
- /discovery/cml/trending_list/ aanroepen met een advertentietoken. De nummerendpoints vragen om een token van een TikTok-account en business_id, zoals de Accounts API ook doet.
- Een duur van 0 lezen als een kapot nummer. TikTok meldt dat een nummer dat alleen een clip van een langer stuk is 0 kan tonen, dus controleer de preview voordat je begin en einde kiest.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan ik elk nummer aan een TikTok-post toevoegen via de API?
Nummers uit de Commercial Music Library, op ID. Muziek die al in een videobestand is gemengd gaat met het bestand mee, dus het moet muziek zijn waarvoor je de gebruiksrechten hebt.
Welk volume stelt de API van TikTok in voor toegevoegde muziek?
Standaard 0. music_sound_volume en video_original_sound_volume lopen van 0 tot 100 en staan beide standaard op 0 via de API, terwijl de TikTok-app op 50 begint, dus stel ze per video met een nummer in.
Maakt de muziek van een post uit als de post later in een advertentie wordt gebruikt?
TikTok controleert dat: /identity/music/authorization/ meldt voor de locaties en periodes van de advertentie of de muziek van de post volledig is geautoriseerd, ontbreekt aan autorisatie of geen song-ID heeft.
Hoeveel nummers zitten er in de Commercial Music Library van TikTok?
1 miljoen, volgens het Business Help Center van TikTok, allemaal vooraf goedgekeurd voor commercieel gebruik. /discovery/cml/trending_list/ geeft er tot 100 populaire tegelijk terug.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op