Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Pagdagdag ng music sa TikTok posts gamit ang API

Nagdaragdag ang TikTok API ng music mula sa Commercial Music Library. Tumatanggap ang post_info.music_sound_info ng music_sound_id ng isang track sa video at photo posts. Sa videos, maaari ring itakda ang volume ng track, ang simula at dulo nito sa milliseconds, at ang volume ng sariling sound ng video. Maaari ring gamitin ng photo posts ang auto_add_music para sa inirerekomendang music. Nagmumula ang track IDs sa GET /discovery/cml/trending_list/.

Nagpa-publish ang easyCoexistence ng TikTok videos at photo posts gamit ang publish_tiktok_post mula sa Claude, ChatGPT, o sarili ninyong code, ngayon o sa nakatakdang oras hanggang 90 araw nang maaga, at lumalabas ang video na nahalo ang soundtrack sa file nito.

100

Pinakasikat na tracks na ibinabalik ng /discovery/cml/trending_list/, lahat ay pre-cleared para sa organic content at paggawa ng ad.

0 to 100

Saklaw ng music_sound_volume at video_original_sound_volume; sa pamamagitan ng API, parehong nakatakda sa 0 bilang default, samantalang nagsisimula sa 50 ang TikTok app.

1 million

Mga kanta sa Commercial Music Library ng TikTok, ang pre-cleared na global library na ginagamit ng mga negosyo para sa commercial na aktibidad sa TikTok.

TikTok only

Kung saan maaaring ipakita ang creatives na gawa gamit ang music mula sa music list ng TikTok ads, maliban kung magbibigay ng hiwalay na pahintulot ang may-ari ng karapatan.

DIRECT_POST

Ang tanging post_mode kung saan ina-apply ng photo endpoint ng Content Posting API ang auto_add_music, sa developers.tiktok.com.

Aling music fields ang tinatanggap ng publish endpoints ng TikTok?

Pareho ang dalawang endpoint na nagdadala ng music sa loob ng post_info, sa ilalim ng music_sound_info, at tinutukoy ang track sa pamamagitan ng Commercial Music Library ID nito. Lampas doon ay magkaiba sila: nagdaragdag ang video endpoint ng mixing controls, at ang photo endpoint naman ng switch na nagpapahintulot sa TikTok na pumili ng music. Magkatabi, gaya ng nakalista sa mga reference ng TikTok:

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

Paano magdagdag ng track sa video?

Ipadala ang music_sound_info sa loob ng post_info sa POST /business/video/publish/. Kapag nasa object na, kailangan ang music_sound_id at music_sound_volume. Pinipili ng music_sound_start at music_sound_end ang bahagi ng track sa milliseconds, mula sa simula ng track hanggang sa buong haba ng video bilang default, kaya ang 2-second na video ay kumukuha ng unang 2,000 milliseconds ng track. Itakda rin ang video_original_sound_volume kapag mahalaga ang sariling audio ng video, dahil 0 ito bilang default:

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

Saan galing ang track IDs?

Mula sa GET /discovery/cml/trending_list/, isang Discovery API endpoint na tumatanggap ng access token ng TikTok account at business_id, samantalang ang token ng Discovery hashtag endpoints ay sa advertiser. Inilalagay ito ng reference ng TikTok sa ilalim ng Discovery permission ng Creative Management. Nagbabalik ito ng hanggang 100 pinakasikat na track, bawat isa may pangalan, artist, duration, rank, genres, preview_url na hindi nag-e-expire, at hanggang 30 araw ng trending_history. Ang full_duration_song_clip at trending_song_clip ay bawat isa may song_clip_id, ang halagang tinutukoy ng TikTok bilang music_sound_id:

  • genre: ALL bilang default, o isa sa mahigit 100 value gaya ng POP, LATIN, LO-FI o SERTANEJO.
  • country_code: US bilang default. date_range: 1DAY, 7DAY bilang default, 30DAY o 90DAY.
  • /discovery/cml/video_list/: ang nangungunang 20 trending videos na gumagamit ng track, ayon sa commercial_music_id nito at 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'

Paano nakakakuha ng music ang photo posts?

Dalawang paraan sa POST /business/photo/publish/. Ang auto_add_music na nakatakda sa true ay nagpapahintulot sa TikTok na magdagdag ng inirerekomendang music, na mababago ng may-ari sa TikTok app pagkatapos. Ang music_sound_info.music_sound_id ay tumutukoy sa partikular na track ng library, na walang volume, simula, o dulo para sa photos. Sa developers.tiktok.com, may sariling auto_add_music ang photo endpoint ng Content Posting API, na ina-apply lamang kapag DIRECT_POST ang post_mode, at ang direct-post video endpoint nito ay walang nakadokumentong music field.

Ano ang ibig sabihin ng Commercial Music Library para sa mga negosyong account?

Ito ang music na maaari nilang gamitin. Inilalarawan ng Help Center para sa negosyo ng TikTok ang library bilang pre-cleared na global na koleksyon ng 1 milyong kanta, sinasabing hindi maaaring gamitin ng mga negosyo ang general music library para sa commercial na gamit, at itinuturo sila sa Commercial Music Library para sa organic content, duets, reacts at stitches kasama, video ads, at branded content. Sa negosyong account, ang Add Sound sa app ay nagpapakita lamang ng library sounds, at ang API ay naglalagay ng parehong hangganan, dahil ang music_sound_id ay tumatanggap ng library ID.

Ano ang hindi magawa ng API sa music?

May ilang bagay na nasa labas ng mga field nito, ayon sa paglalarawan ng reference ng TikTok:

  • Tumukoy ng sound mula sa general library ng TikTok: ang music_sound_id ay tumatanggap ng Commercial Music Library ID.
  • Maghanap sa library ayon sa title: sinasala ng /discovery/cml/trending_list/ ang mga sikat na track ayon sa genre, country at panahon.
  • Panatilihin ang music sa draft: ginagawang balewala ng upload_to_draft ang natitirang post_info ng TikTok, at ang is_draft ay nagtatago lamang ng title at caption.
  • Gamitin ang sariling track sa organic post: nagdaragdag ang /file/music/upload/ ng music para sa ad creatives sa ilalim ng advertiser_id, at ayon sa abiso ng TikTok doon, nasa uploader ang responsibilidad sa copyright.

Ano ang mga workaround?

Tatlo, bawat isa ay nakabatay sa nakadokumentong reference ng TikTok, kasama ang isang panganib na dapat timbangin:

  • Ihalo ang music sa file. Inilalarawan ng constraints ng TikTok ang video bilang audio-video content, kaya kasama itong lalabas ang soundtrack na nahalo; gumamit ng audio na hawak ninyo ang mga karapatan.
  • Magpadala ng draft. Gamit ang upload_to_draft o is_draft at ang video.upload scope, napupunta ang post sa TikTok inbox ng creator, para i-edit at i-post sa app.
  • Hayaang pumili ang TikTok sa photo posts. Nagdaragdag ang auto_add_music ng inirerekomendang music, at maaaring palitan ito ng may-ari sa TikTok app pagkatapos.
  • Ang panganib sa mixed audio: ang post list reference ng TikTok ay nagbanggit ng music copyright violations bilang isa sa mga posibleng dahilan kung bakit na-filter out ang post.

Paano makikita kung nagdala ng views ang isang sound?

Sa pamamagitan ng impression_sources, isang field ng /business/video/list/ na nagra-rank kung saan natagpuan ng mga viewer ang post; isa sa mga value nito ay Sound, para sa views na galing sa sound pages. Kailangan nito ang video.insights scope at, tulad ng ibang bilang, dumarating nang 24 hanggang 48 oras na huli. Sa easyCoexistence, ibinabalik ito ng get_social_insights para sa isa sa 20 pinakabagong post ng account kapag nakalista ang impression_sources sa metrics, kasama ang item_id ng post bilang object_id.

Ano ang ginagawa ng easyCoexistence sa music?

Nagpa-publish ang easyCoexistence ng sound na nasa file na ninyo. Ang publish_tiktok_post, ngayon man o sa scheduled_at, ay nagpapadala ng caption, title ng photo post, at comment setting, nang walang music_sound_info at walang auto_add_music, kaya pinapanatili ng video ang sariling soundtrack nito at lumalabas nang walang music ang photo post. Maaaring mag-POST ang sarili ninyong code sa business/video/publish/ na may music_sound_info at ang token mula sa get_social_credentials, pero ang body na iyon ay dumarating sa TikTok nang eksakto, kasama ang video_url, at kumukuha ang TikTok ng media lamang mula sa mga domain o URL prefix na na-verify para sa app. Token ng advertiser ang kinukuha ng /discovery/ paths, kaya hindi abot ng token ng account ang listahan ng track.

Mga karaniwang pagkakamali

  • Hindi paglalagay ng video_original_sound_volume kapag nagdaragdag ng track. Sa pamamagitan ng API, 0 ito bilang default, samantalang sinisimulan ng TikTok app ang parehong sound sa 50, kaya itakda ito kapag mahalaga ang sariling audio ng video.
  • Pagpasa ng pangalan o preview_url ng track bilang music_sound_id. Tinutukoy ng track reference ng TikTok ang song_clip_id, mula sa full_duration_song_clip o trending_song_clip, bilang halagang ipapasa.
  • Pagtawag sa /discovery/cml/trending_list/ gamit ang advertiser token. Ang track endpoints ay tumatanggap ng token ng TikTok account at business_id, gaya ng Accounts API.
  • Pagbasa sa duration na 0 bilang sirang track. Sinasabi ng TikTok na ang track na clip lamang ng mas mahabang piyesa ay maaaring magpakita ng 0, kaya suriin muna ang preview nito bago piliin ang start at end.
Ginagawa ito gamit ang EasyCoexistence

US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.

Mga madalas itanong

Puwede bang magdagdag ng kahit anong kanta sa TikTok post sa pamamagitan ng API?

Mga kanta sa Commercial Music Library, sa pamamagitan ng ID. Ang music na nahalo na sa video file ay lalabas kasama ng file, kaya dapat ay music na may karapatan kayong gamitin.

Anong volume ang itinatakda ng API ng TikTok para sa idinagdag na music?

0 bilang default. Ang music_sound_volume at video_original_sound_volume ay mula 0 hanggang 100 at parehong 0 bilang default sa pamamagitan ng API, samantalang nagsisimula sa 50 ang TikTok app, kaya itakda ang mga ito sa bawat video na may track.

Mahalaga ba ang music ng post kung gagamitin ito sa ad sa bandang huli?

Oo, sinusuri ito ng TikTok: iniuulat ng /identity/music/authorization/, para sa mga lokasyon at petsa ng pagtakbo ng ad, kung ganap na awtorisado ang music ng post, kulang ang authorization, o walang song ID.

Ilan ang kanta sa Commercial Music Library ng TikTok?

1 milyon, ayon sa Help Center para sa negosyo ng TikTok, lahat ay pre-cleared para sa commercial na gamit. Nagbabalik ang /discovery/cml/trending_list/ ng hanggang 100 sikat na kanta sa isang pagkakataon.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong