Dodavanje glazbe TikTok objavama putem API-ja
TikTokov API for Business dodaje glazbu iz njegove biblioteke Commercial Music Library: post_info.music_sound_info prima music_sound_id pjesme na videozapisima i fotografijama, a na videozapisima i glasnoću pjesme, početak i kraj u milisekundama te glasnoću vlastitog zvuka videozapisa. Objave fotografija mogu primiti i auto_add_music za preporučenu glazbu. ID-jevi pjesama dolaze iz GET /discovery/cml/trending_list/.
easyCoexistence objavljuje TikTok videozapise i fotografske objave pomoću publish_tiktok_post iz Claudea, ChatGPT-ja ili vlastitog koda, odmah ili u zadano vrijeme do 90 dana unaprijed, a videozapis ide sa zvučnom podlogom umiješanom u datoteku.
Najpopularnije pjesme koje vraća /discovery/cml/trending_list/, sve unaprijed odobrene za organski sadržaj i izradu oglasa.
Raspon music_sound_volume i video_original_sound_volume; putem API-ja oba su zadana na 0, dok aplikacija TikTok kreće od 50.
Pjesme u Commercial Music Library, unaprijed odobrenoj globalnoj biblioteci koju tvrtke koriste za komercijalne aktivnosti na TikToku.
Mjesta na kojima mogu biti prikazane kreacije s glazbom s TikTokova popisa glazbe za oglase, osim ako nositelji prava ne daju zasebno dopuštenje.
Jedini post_mode u kojem fotografski endpoint Content Posting API-ja primjenjuje auto_add_music, na developers.tiktok.com.
Koja polja za glazbu prihvaćaju TikTokovi endpointi za objavu?
Oba endpointa nose glazbu unutar post_info, pod music_sound_info, i pjesmu određuju njezinim ID-jem iz Commercial Music Library. Osim toga razlikuju se: endpoint za videozapise dodaje kontrole miješanja, a endpoint za fotografije sklopku koja TikToku omogućuje da odabere glazbu. Usporedno, kako ih navode TikTokove reference:
| 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 |
Kako dodati pjesmu videozapisu?
Pošaljite music_sound_info unutar post_info na POST /business/video/publish/. Kad je objekt tu, music_sound_id i music_sound_volume su obavezni. music_sound_start i music_sound_end biraju dio pjesme u milisekundama, a zadano je od početka pjesme do pune duljine videozapisa, pa 2-sekundni videozapis uzima prvih 2.000 milisekundi pjesme. Postavite i video_original_sound_volume kad je zvuk samog videozapisa važan, jer je zadan na 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
}
}
}'Odakle dolaze ID-jevi pjesama?
Iz GET /discovery/cml/trending_list/, endpointa Discovery API-ja koji prima access token TikTok računa i business_id, za razliku od hashtag endpointa koji primaju oglašivačev token. TikTokova referenca navodi ga pod dopuštenjem Discovery u sklopu Creative Management. Vraća do 100 popularnih pjesama, svaku s imenom, izvođačem, trajanjem, rangom, žanrovima, preview_url koji ne istječe i do 30 dana trending_history. full_duration_song_clip i trending_song_clip svaki sadrži song_clip_id, vrijednost koju TikTok naziva music_sound_id:
- žanr: ALL po zadanom, ili jedna od više od 100 vrijednosti, poput POP, LATIN, LO-FI ili SERTANEJO.
country_code: US po zadanom.date_range: 1DAY, 7DAY po zadanom, 30DAY ili 90DAY.- /discovery/cml/
video_list/: 20 najpopularnijih videozapisa u trendu koji koriste pjesmu, prema njezinucommercial_music_idicountry_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'Kako fotografske objave dobivaju glazbu?
Na dva načina na POST /business/photo/publish/. auto_add_music postavljen na true TikToku omogućuje dodavanje preporučene glazbe, koju vlasnik kasnije može promijeniti u aplikaciji TikTok. music_sound_info.music_sound_id navodi određenu pjesmu iz biblioteke, bez polja za glasnoću, početak i kraj na fotografijama. Na developers.tiktok.com, endpoint za fotografije u Content Posting API-ju ima vlastiti auto_add_music, primijenjen samo kad je post_mode DIRECT_POST, a njegov endpoint za izravnu objavu videozapisa ne dokumentira polje za glazbu.
Što Commercial Music Library znači za poslovne račune?
To je glazba koju smiju koristiti. TikTokov centar za pomoć poslovnim korisnicima opisuje biblioteku kao unaprijed odobrenu globalnu zbirku od 1 milijun pjesama, navodi da poslovni računi ne smiju koristiti opću glazbenu biblioteku u komercijalne svrhe i upućuje ih na Commercial Music Library za organski sadržaj, duete, reakcije i stitcheve, video-oglase i brendirani sadržaj. Na poslovnom računu „Add Sound“ u aplikaciji prikazuje samo zvukove iz biblioteke, a API povlači istu granicu, jer music_sound_id prima ID iz biblioteke.
Što API ne može učiniti s glazbom?
Nekoliko stvari leži izvan njegovih polja, kako ih opisuju TikTokove reference:
- Navesti zvuk iz opće TikTokove biblioteke:
music_sound_idprima ID iz Commercial Music Library. - Pretraživati biblioteku po naslovu: /discovery/cml/
trending_list/ filtrira popularne pjesme po žanru, državi i razdoblju. - Zadržati glazbu na nacrtu:
upload_to_draftuzrokuje da TikTok zanemari ostatakpost_infa, ais_draftzadržava samo naslov i opis. - Koristiti vlastitu pjesmu u organskoj objavi: /file/music/upload/ dodaje glazbu za oglasne kreacije pod
advertiser_id, a TikTokova napomena tamo prepušta odgovornost za autorska prava onome tko učitava.
Koja su zaobilazna rješenja?
Tri, svako utemeljeno na onome što TikTokove reference dokumentiraju, plus jedan rizik koji treba odvagnuti:
- Umiješajte glazbu u datoteku. TikTokova ograničenja opisuju videozapis kao audiovizualni sadržaj, pa miješani zvuk ide zajedno s njim; koristite zvuk na koji imate prava.
- Pošaljite nacrt. S
upload_to_draftiliis_draftuz dopuštenje video.upload objava završava u TikTok inboxu kreatora, za uređivanje i objavu u aplikaciji. - Prepustite izbor TikToku kod fotografija.
auto_add_musicdodaje preporučenu glazbu, a vlasnik je kasnije može zamijeniti u aplikaciji TikTok. - Rizik s miješanim zvukom: TikTokov popis objava navodi kršenje autorskih prava na glazbu među vjerojatnim razlozima za filtriranje objave.
Kako vidjeti je li zvuk donio preglede?
Putem impression_sources, polja /business/video/list/ koje rangira odakle su gledatelji pronašli objavu; jedna od vrijednosti je Sound, za preglede koji su došli sa stranica zvukova. Treba dopuštenje video.insights i, kao i ostali brojevi, kasni 24 do 48 sati. Putem easyCoexistence, get_social_insights vraća ga za jednu od 20 najnovijih objava računa kad je impression_sources naveden u metrics, s item_id objave kao object_id.
Što easyCoexistence radi s glazbom?
Objavljuje zvuk koji već imate u datoteci. publish_tiktok_post, odmah ili s scheduled_at, šalje opis, naslov fotografske objave i postavku komentara, bez music_sound_info i auto_add_music, pa videozapis zadržava vlastitu zvučnu podlogu, a fotografska objava ide bez glazbe. Vaš vlastiti kod može slati POST na business/video/publish/ s music_sound_info i tokenom iz get_social_credentials, ali to tijelo ide TikToku kakvo je napisano, uključujući video_url, a TikTok dohvaća medije samo s domena ili prefiksa URL-a koji su provjereni za aplikaciju. Putanje /discovery/ traže oglašivačev token, pa je popis pjesama izvan dosega tokena računa.
Uobičajene pogreške
- Izostavljanje video_original_sound_volume pri dodavanju pjesme. Putem API-ja zadan je na 0, dok aplikacija TikTok oba zvuka pokreće na 50, pa ga postavite kad je zvuk samog videozapisa važan.
- Slanje naziva pjesme ili preview_url kao music_sound_id. TikTokova referenca navodi song_clip_id, iz full_duration_song_clip ili trending_song_clip, kao vrijednost koju treba proslijediti.
- Pozivanje /discovery/cml/trending_list/ s tokenom oglašivača. Endpointi za pjesme primaju token TikTok računa i business_id, kao i Accounts API.
- Čitanje trajanja 0 kao neispravne pjesme. TikTok napominje da pjesma koja je samo isječak duže skladbe može prikazati 0, pa provjerite njezin pregled prije odabira početka i kraja.
Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prvih 3 dana je besplatno.
Često postavljana pitanja
Mogu li dodati bilo koju pjesmu TikTok objavi putem API-ja?
Pjesme iz Commercial Music Library, po ID-u. Glazba već umiješana u datoteku videozapisa ide zajedno s datotekom, pa treba biti glazba na koju imate prava korištenja.
Koju glasnoću TikTokov API postavlja za dodanu glazbu?
0 po zadanom. music_sound_volume i video_original_sound_volume kreću se od 0 do 100, a putem API-ja oba su zadana na 0, dok aplikacija TikTok kreće od 50, pa ih postavite za svaki videozapis s pjesmom.
Je li glazba objave bitna ako se objava kasnije koristi u oglasu?
TikTok to provjerava: /identity/music/authorization/ izvješćuje, za lokacije oglasa i datume prikazivanja, je li glazba objave potpuno odobrena, nedostaje li odobrenje ili je bez ID-a pjesme.
Koliko pjesama ima TikTokova Commercial Music Library?
1 milijun, prema TikTokovu centru za pomoć poslovnim korisnicima, sve unaprijed odobrene za komercijalnu upotrebu. /discovery/cml/trending_list/ vraća do 100 popularnih odjednom.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na