EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

100

Faixas mais populares que /discovery/cml/trending_list/ retorna, todas pré-liberadas para conteúdo orgânico e criação de anúncios.

0 to 100

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.

1 million

Músicas da Commercial Music Library do TikTok, a biblioteca global pré-liberada que empresas usam para atividade comercial no TikTok.

TikTok only

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.

DIRECT_POST

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

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:

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

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 seu commercial_music_id e um 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'

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_id recebe 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_draft faz o TikTok ignorar o restante de post_info, e is_draft manté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_draft ou is_draft e 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_music adiciona 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.
Fazendo isso com o EasyCoexistence

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