Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Añadir música a publicaciones de TikTok mediante la API

La API for Business de TikTok añade música de su Commercial Music Library: post_info.music_sound_info acepta el music_sound_id de una pista en publicaciones de video y de foto, y en los videos también el volumen de la pista, su inicio y su fin en milisegundos, y el volumen del sonido propio del video. Las publicaciones de foto también pueden usar auto_add_music para música recomendada. Los ID de las pistas salen de GET /discovery/cml/trending_list/.

El publish_tiktok_post de easyCoexistence publica videos y posts de fotos de TikTok, sin enviar campos de música, así que el video conserva la pista mezclada en su archivo.

100

Las pistas más populares que devuelve /discovery/cml/trending_list/, todas preautorizadas para contenido orgánico y creación de anuncios.

0 to 100

Rango de music_sound_volume y video_original_sound_volume; por la API ambos valen 0 por defecto, mientras que la app de TikTok empieza en 50.

1 million

Canciones de la Commercial Music Library de TikTok, la biblioteca global preautorizada que las empresas usan para su actividad comercial en TikTok.

TikTok only

Dónde pueden aparecer los creativos hechos con música de la lista de música para anuncios de TikTok, salvo que los titulares de derechos den permiso por separado.

DIRECT_POST

El único post_mode en el que el endpoint de fotos de la Content Posting API aplica auto_add_music, en developers.tiktok.com.

¿Qué campos de música aceptan los endpoints de publicación de TikTok?

Ambos endpoints llevan la música dentro de post_info, bajo music_sound_info, y nombran una pista por su ID de Commercial Music Library. Más allá de eso difieren: el endpoint de video añade controles de mezcla, y el de fotos añade una opción que permite a TikTok elegir la música. Lado a lado, tal como los listan las referencias de 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

¿Cómo se añade una pista a un video?

Envía music_sound_info dentro de post_info en POST /business/video/publish/. Una vez presente el objeto, music_sound_id y music_sound_volume son obligatorios. music_sound_start y music_sound_end eligen la parte de la pista en milisegundos, desde el inicio de la pista hasta la duración completa del video por defecto, así que un video de 2 segundos toma los primeros 2,000 milisegundos de la pista. Define también video_original_sound_volume siempre que el audio propio del video importe, ya que por defecto vale 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 dónde salen los ID de las pistas?

De GET /discovery/cml/trending_list/, un endpoint de la Discovery API que recibe el access token de una cuenta de TikTok y business_id, donde los endpoints de hashtags de Discovery reciben el de un anunciante; la referencia de TikTok lo clasifica bajo el permiso Discovery de Creative Management. Devuelve hasta 100 pistas populares, cada una con su nombre, artista, duración, posición en el ranking, géneros, un preview_url que no caduca y hasta 30 días de trending_history. full_duration_song_clip y trending_song_clip contienen cada uno un song_clip_id, el valor que TikTok llama music_sound_id:

  • genre: ALL por defecto, o uno de más de 100 valores como POP, LATIN, LO-FI o SERTANEJO.
  • country_code: US por defecto. date_range: 1DAY, 7DAY por defecto, 30DAY o 90DAY.
  • /discovery/cml/video_list/: los 20 videos en tendencia más destacados que usan una pista, por su commercial_music_id y un 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'

¿Cómo obtienen música las publicaciones de foto?

De dos formas en POST /business/photo/publish/. auto_add_music en true hace que TikTok añada música recomendada, que el titular puede cambiar después en la app de TikTok; music_sound_info.music_sound_id nombra una pista específica de la biblioteca, sin campos de volumen, inicio o fin en las fotos. En developers.tiktok.com, el endpoint de fotos de la Content Posting API tiene su propio auto_add_music, aplicado solo cuando post_mode es DIRECT_POST, y su endpoint de video de publicación directa no documenta ningún campo de música.

¿Qué significa la Commercial Music Library para las cuentas de empresa?

Es la música que pueden usar. El Business Help Center de TikTok describe la biblioteca como una colección global preautorizada de 1 millón de canciones, dice que las empresas no pueden usar la biblioteca musical general con fines comerciales, y las remite a la Commercial Music Library para contenido orgánico, dúos, reacciones y stitches incluidos, anuncios de video y contenido de marca. En una cuenta Business, Add Sound en la app muestra solo sonidos de la biblioteca, y la API traza la misma línea, ya que music_sound_id acepta un ID de la biblioteca.

¿Qué no puede hacer la API con la música?

Algunas cosas quedan fuera de sus campos, según describen las referencias de TikTok:

  • Nombrar un sonido de la biblioteca general de TikTok: music_sound_id acepta un ID de Commercial Music Library.
  • Buscar la biblioteca por título: /discovery/cml/trending_list/ filtra las pistas populares por género, país y periodo.
  • Mantener música en un borrador: upload_to_draft hace que TikTok ignore el resto de post_info, y is_draft conserva solo el título y la descripción.
  • Usar tu propia pista en una publicación orgánica: /file/music/upload/ añade música para creativos de anuncios bajo un advertiser_id, y el aviso de TikTok allí deja la responsabilidad por derechos de autor en quien sube el archivo.

¿Cuáles son las alternativas?

Tres, cada una basada en lo que documentan las referencias de TikTok, más un riesgo que conviene sopesar:

  • Mezclar la música en el archivo. Las restricciones de TikTok describen el video como contenido de audio y video, así que una banda sonora mezclada sale con él; usa audio sobre el que tengas los derechos.
  • Enviar un borrador. Con upload_to_draft o is_draft y el scope video.upload, la publicación llega a la bandeja de entrada de TikTok del creador, para editarla y publicarla en la app.
  • Dejar que TikTok elija en las fotos. auto_add_music añade música recomendada, y el titular puede cambiarla después en la app de TikTok.
  • El riesgo con el audio mezclado: la referencia de la lista de publicaciones de TikTok menciona las infracciones de derechos musicales entre los motivos probables por los que se excluye una publicación.

¿Cómo se ve si un sonido trajo visualizaciones?

A través de impression_sources, un campo de /business/video/list/ que clasifica desde dónde encontraron la publicación sus espectadores; uno de sus valores es Sound, para visualizaciones que llegaron desde páginas de sonidos. Requiere el scope video.insights y, como los demás conteos, llega entre 24 y 48 horas tarde. Mediante easyCoexistence, get_social_insights lo devuelve para una de las 20 publicaciones más recientes de la cuenta cuando impression_sources se indica en metrics, con el item_id de la publicación como object_id.

¿Qué hace easyCoexistence con la música?

Publica el sonido que ya está en tu archivo. publish_tiktok_post, ahora o con scheduled_at, envía la descripción, el título de una publicación de foto y la configuración de comentarios, sin music_sound_info ni auto_add_music, así un video conserva su propia banda sonora y una publicación de foto sale sin música. Tu propio código puede hacer POST a business/video/publish/ con music_sound_info y el token de get_social_credentials, pero ese cuerpo llega a TikTok tal cual, incluido video_url, y TikTok obtiene los medios solo de dominios o prefijos de URL verificados para la app. Las rutas /discovery/ piden el token de un anunciante, así que la lista de pistas está fuera del alcance del token de la cuenta.

Errores comunes

  • Omitir video_original_sound_volume al añadir una pista. Por la API vale 0 por defecto, mientras que la app de TikTok empieza ambos sonidos en 50, así que defínelo siempre que el audio propio del video importe.
  • Pasar el nombre o el preview_url de una pista como music_sound_id. La referencia de pistas de TikTok indica que el valor a pasar es song_clip_id, de full_duration_song_clip o trending_song_clip.
  • Llamar a /discovery/cml/trending_list/ con un token de anunciante. Los endpoints de pistas reciben el token de una cuenta de TikTok y business_id, como la Accounts API.
  • Tomar una duración de 0 como señal de una pista rota. TikTok señala que una pista que es solo un fragmento de una pieza más larga puede mostrar 0, así que revisa su vista previa antes de elegir inicio y fin.
Hacerlo con EasyCoexistence

easyCoexistence publica videos y publicaciones de foto de TikTok con publish_tiktok_post desde Claude, ChatGPT o tu propio código, ahora o con hasta 90 días de antelación, y un video sale con la banda sonora mezclada en su archivo. De US$ 9 a US$ 0.75 por conexión al mes, con descuento a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo añadir cualquier canción a una publicación de TikTok por la API?

Canciones de la Commercial Music Library, por ID. La música ya mezclada en un archivo de video sale con el archivo, así que debe ser música sobre la que tengas derecho de uso.

¿Qué volumen pone la API de TikTok a la música añadida?

0 por defecto. music_sound_volume y video_original_sound_volume van de 0 a 100 y ambos valen 0 por defecto por la API, mientras que la app de TikTok empieza en 50, así que defínelos en cada video con una pista.

¿Importa la música de una publicación si después se usa en un anuncio?

TikTok la revisa: /identity/music/authorization/ informa, para las ubicaciones y fechas de emisión del anuncio, si la música de la publicación está completamente autorizada, si falta autorización o si no tiene ID de canción.

¿Cuántas canciones hay en la Commercial Music Library de TikTok?

1 millón, según el Business Help Center de TikTok, todas preautorizadas para uso comercial. /discovery/cml/trending_list/ devuelve hasta 100 de las populares a la vez.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el