Adicionar música a posts do TikTok pela API
A API for Business do TikTok adiciona música da Commercial Music Library: post_info.music_sound_info recebe o music_sound_id de uma faixa em vídeos e posts de fotos, e, em vídeos, também o volume da faixa, seu início e fim em milissegundos e o volume do som original do vídeo. Posts de fotos também podem receber auto_add_music para música recomendada. Os IDs das faixas vêm de GET /discovery/cml/trending_list/.
O publish_tiktok_post do easyCoexistence publica vídeos e posts de fotos do TikTok, sem enviar campos de música, então o vídeo mantém a trilha mixada no arquivo.
Faixas mais populares que /discovery/cml/trending_list/ retorna, todas pré-liberadas para conteúdo orgânico e criação de anúncios.
Intervalo de music_sound_volume e video_original_sound_volume; pela API, ambos começam em 0, enquanto o app do TikTok começa em 50.
Músicas da Commercial Music Library do TikTok, a biblioteca global pré-liberada que empresas usam para atividade comercial no TikTok.
Onde podem ser exibidos criativos feitos com músicas da lista de músicas para anúncios do TikTok, salvo permissão separada dos detentores dos direitos.
O único post_mode em que o endpoint de fotos da Content Posting API aplica auto_add_music, em developers.tiktok.com.
Quais campos de música os endpoints de publicação do TikTok aceitam?
Os dois endpoints carregam música dentro de post_info, em music_sound_info, e identificam uma faixa pelo seu ID na Commercial Music Library. Além disso, diferem: o endpoint de vídeo acrescenta controles de mixagem, e o endpoint de fotos acrescenta uma opção que permite ao TikTok escolher a música. Lado a lado, como as referências do TikTok as listam:
| 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 |
Como adicionar uma faixa a um vídeo?
Envie music_sound_info dentro de post_info em POST /business/video/publish/. Uma vez presente o objeto, music_sound_id e music_sound_volume são obrigatórios. music_sound_start e music_sound_end escolhem o trecho da faixa em milissegundos, do início da faixa até a duração total do vídeo por padrão; assim, um vídeo de 2 segundos usa os primeiros 2.000 milissegundos da faixa. Defina também video_original_sound_volume sempre que o áudio original do vídeo for importante, já que ele começa em 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
}
}
}'De onde vêm os IDs das faixas?
De GET /discovery/cml/trending_list/, um endpoint da Discovery API que recebe o access token de uma conta do TikTok e o business_id, enquanto os endpoints de hashtag da Discovery recebem o token de um anunciante; a referência do TikTok o classifica na permissão Discovery do Creative Management. Ele retorna até 100 faixas populares, cada uma com nome, artista, duração, posição, gêneros, um preview_url que não expira e até 30 dias de trending_history. full_duration_song_clip e trending_song_clip contêm cada um um song_clip_id, o valor que o TikTok chama de music_sound_id:
- genre: ALL por padrão, ou um dos mais de 100 valores, como POP, LATIN, LO-FI ou SERTANEJO.
country_code: US por padrão.date_range: 1DAY, 7DAY por padrão, 30DAY ou 90DAY.- /discovery/cml/
video_list/: os 20 vídeos em alta que mais usam uma faixa, pelo seucommercial_music_ide umcountry_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'Como posts de fotos recebem música?
De duas formas em POST /business/photo/publish/. auto_add_music definido como true faz o TikTok adicionar música recomendada, que o dono pode trocar depois no app do TikTok; music_sound_info.music_sound_id indica uma faixa específica da biblioteca, sem campos de volume, início ou fim em fotos. No developers.tiktok.com, o endpoint de fotos da Content Posting API tem seu próprio auto_add_music, aplicado somente quando post_mode é DIRECT_POST, e seu endpoint de vídeo de publicação direta não documenta campo de música.
O que a Commercial Music Library significa para contas comerciais?
É a música que elas podem usar. A Central de Ajuda para Empresas do TikTok descreve a biblioteca como uma coleção global pré-liberada de 1 milhão de músicas, diz que empresas não podem usar a biblioteca musical geral para fins comerciais, e as direciona à Commercial Music Library para conteúdo orgânico, duetos, reações e stitches incluídos, anúncios em vídeo e conteúdo de marca. Em uma conta comercial, Adicionar som no app mostra apenas sons da biblioteca, e a API traça a mesma linha, já que music_sound_id recebe um ID da biblioteca.
O que a API não consegue fazer com música?
Algumas coisas ficam fora de seus campos, conforme descrevem as referências do TikTok:
- Nomear um som da biblioteca geral do TikTok:
music_sound_idrecebe um ID da Commercial Music Library. - Pesquisar a biblioteca pelo título: /discovery/cml/
trending_list/ filtra faixas populares por gênero, país e período. - Manter música em um rascunho:
upload_to_draftfaz o TikTok ignorar o restante depost_info, eis_draftmantém apenas o título e a legenda. - Usar uma faixa própria em post orgânico: /file/music/upload/ adiciona música para criativos de anúncios sob um
advertiser_id, e o aviso do TikTok ali deixa a responsabilidade por direitos autorais com quem envia.
Quais são as alternativas?
Três, cada uma baseada no que as referências do TikTok documentam, mais um risco a considerar:
- Misture a música ao arquivo. As restrições do TikTok descrevem o vídeo como conteúdo de áudio e vídeo, então uma trilha mixada sai junto com ele; use áudio sobre o qual você tenha os direitos.
- Envie um rascunho. Com
upload_to_draftouis_drafte o escopo video.upload, o post chega à caixa de entrada do criador no TikTok, para editar e publicar no app. - Deixe o TikTok escolher em posts de fotos.
auto_add_musicadiciona música recomendada, e o dono pode trocá-la depois no app do TikTok. - O risco com áudio misturado: a referência da lista de posts do TikTok cita violações de direitos autorais musicais entre os motivos prováveis para um post ser filtrado.
Como saber se um som trouxe visualizações?
Pelo impression_sources, um campo de /business/video/list/ que ordena por onde os espectadores de um post o encontraram; um de seus valores é Sound, para visualizações vindas de páginas de som. Ele exige o escopo video.insights e, como as demais métricas, chega com 24 a 48 horas de atraso. Pelo easyCoexistence, get_social_insights retorna o campo para um dos 20 posts mais recentes da conta quando impression_sources é indicado em metrics, com o item_id do post como object_id.
O que o easyCoexistence faz com música?
Publica o som que já está no seu arquivo. publish_tiktok_post, agora ou com scheduled_at, envia a legenda, o título de um post de fotos e a configuração de comentários, sem music_sound_info e sem auto_add_music; assim, um vídeo mantém a própria trilha e um post de fotos sai sem música. O seu próprio código pode fazer POST em business/video/publish/ com music_sound_info e o token de get_social_credentials, mas esse corpo chega ao TikTok como escrito, incluindo video_url, e o TikTok busca mídia apenas em domínios ou prefixos de URL verificados para o app. Caminhos /discovery/ recebem o token de um anunciante, então a lista de faixas está fora do alcance do token da conta.
Erros comuns
- Deixar video_original_sound_volume de fora ao adicionar uma faixa. Pela API, ele começa em 0, enquanto o app do TikTok inicia os dois sons em 50; defina-o sempre que o áudio original do vídeo for importante.
- Passar o nome ou o preview_url de uma faixa como music_sound_id. A referência de faixas do TikTok indica song_clip_id, de full_duration_song_clip ou trending_song_clip, como o valor a passar.
- Chamar /discovery/cml/trending_list/ com um token de anunciante. Os endpoints de faixas recebem o token de uma conta do TikTok e o business_id, como a Accounts API.
- Tomar uma duração de 0 como faixa com defeito. O TikTok observa que uma faixa que é apenas um trecho de uma obra maior pode mostrar 0; confira a prévia antes de escolher início e fim.
O easyCoexistence publica vídeos e posts de fotos do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio código, agora ou em horário definido de até 90 dias à frente, e um vídeo sai com a trilha mixada em seu arquivo. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Posso adicionar qualquer música a um post do TikTok pela API?
Músicas da Commercial Music Library, pelo ID. Música já mixada em um arquivo de vídeo sai junto com o arquivo, então deve ser música sobre a qual você tenha os direitos de uso.
Qual volume a API do TikTok define para a música adicionada?
0 por padrão. music_sound_volume e video_original_sound_volume vão de 0 a 100 e ambos começam em 0 pela API, enquanto o app do TikTok começa em 50; defina-os em cada vídeo com uma faixa.
O som de um post importa se ele for usado depois em um anúncio?
O TikTok verifica: /identity/music/authorization/ informa, para os locais e datas de veiculação do anúncio, se a música do post está totalmente autorizada, sem autorização ou sem song ID.
Quantas músicas há na Commercial Music Library do TikTok?
1 milhão, segundo a Central de Ajuda para Empresas do TikTok, todas pré-liberadas para uso comercial. /discovery/cml/trending_list/ retorna até 100 das mais populares por vez.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em