AccediInizia la prova gratuita
easyCoexistence API ufficiali

Aggiungere musica ai post TikTok tramite l'API

L'API for Business di TikTok aggiunge musica dalla sua Commercial Music Library: post_info.music_sound_info accetta il music_sound_id di un brano nei post video e foto, e nei video anche il volume del brano, il suo inizio e la fine in millisecondi e il volume dell'audio originale del video. I post foto possono inoltre usare auto_add_music per la musica consigliata. Gli ID dei brani si ricavano da GET /discovery/cml/trending_list/.

easyCoexistence pubblica video e post foto TikTok con publish_tiktok_post da Claude, ChatGPT o dal tuo codice, subito o a un orario stabilito fino a 90 giorni prima, e un video esce con la colonna sonora mixata nel suo file.

100

I brani più popolari restituiti da /discovery/cml/trending_list/, tutti già autorizzati per contenuti organici e per la creazione di annunci.

0 to 100

Intervallo di music_sound_volume e video_original_sound_volume; tramite l'API entrambi partono da 0, mentre l'app TikTok parte da 50.

1 million

Brani della Commercial Music Library di TikTok, la libreria globale già autorizzata che le aziende usano per l'attività commerciale su TikTok.

TikTok only

Dove possono essere mostrati i creativi realizzati con musica dalla lista musicale degli annunci di TikTok, salvo permesso separato dei titolari dei diritti.

DIRECT_POST

L'unico post_mode in cui l'endpoint foto della Content Posting API applica auto_add_music, su developers.tiktok.com.

Quali campi musicali accettano gli endpoint di pubblicazione di TikTok?

Entrambi gli endpoint inseriscono la musica dentro post_info, sotto music_sound_info, e indicano un brano tramite il suo ID della Commercial Music Library. Oltre a questo differiscono: l'endpoint video aggiunge i controlli di mixaggio, l'endpoint foto aggiunge un interruttore che lascia a TikTok la scelta della musica. Affiancati, come li elencano i riferimenti di 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

Come si aggiunge un brano a un video?

Invia music_sound_info dentro post_info su POST /business/video/publish/. Una volta presente l'oggetto, music_sound_id e music_sound_volume sono obbligatori. music_sound_start e music_sound_end scelgono la parte del brano in millisecondi, dall'inizio del brano fino alla durata completa del video per impostazione predefinita, quindi un video di 2 secondi prende i primi 2.000 millisecondi del brano. Imposta anche video_original_sound_volume ogni volta che l'audio originale del video conta, perché per impostazione predefinita è 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
      }
    }
  }'

Da dove vengono gli ID dei brani?

Da GET /discovery/cml/trending_list/, un endpoint della Discovery API che richiede il token di accesso di un account TikTok e il business_id, mentre gli endpoint hashtag della Discovery richiedono quello di un inserzionista; il riferimento di TikTok lo colloca sotto il permesso Discovery di Creative Management. Restituisce fino a 100 brani popolari, ciascuno con nome, artista, durata, posizione in classifica, generi, un preview_url che non scade e fino a 30 giorni di trending_history. full_duration_song_clip e trending_song_clip contengono ciascuno un song_clip_id, il valore che TikTok indica come music_sound_id:

  • genre: ALL per impostazione predefinita, oppure uno tra oltre 100 valori come POP, LATIN, LO-FI o SERTANEJO.
  • country_code: US per impostazione predefinita. date_range: 1DAY, 7DAY per impostazione predefinita, 30DAY o 90DAY.
  • /discovery/cml/video_list/: i primi 20 video di tendenza che usano un brano, tramite il suo commercial_music_id e 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'

Come ottengono musica i post foto?

In due modi su POST /business/photo/publish/. auto_add_music impostato su true fa sì che TikTok aggiunga musica consigliata, che il proprietario può cambiare in seguito nell'app TikTok; music_sound_info.music_sound_id indica un brano specifico della libreria, senza campi di volume, inizio o fine per le foto. Su developers.tiktok.com, l'endpoint foto della Content Posting API ha un proprio auto_add_music, applicato solo quando post_mode è DIRECT_POST, e il suo endpoint video per la pubblicazione diretta non documenta alcun campo musicale.

Cosa significa la Commercial Music Library per gli account business?

È la musica che possono usare. Il Centro assistenza business di TikTok descrive la libreria come una raccolta globale già autorizzata di 1 milione di brani, afferma che le aziende non possono usare la libreria musicale generale per scopi commerciali, e le indirizza alla Commercial Music Library per i contenuti organici, inclusi duetti, reazioni e stitch, per gli annunci video e per i contenuti di marca. In un Business Account, Aggiungi suono nell'app mostra solo i suoni della libreria, e l'API traccia la stessa linea, dato che music_sound_id accetta un ID della libreria.

Cosa non può fare l'API con la musica?

Alcune cose restano fuori dai suoi campi, come descrivono i riferimenti di TikTok:

  • Indicare un suono della libreria musicale generale: music_sound_id accetta solo un ID della Commercial Music Library.
  • Cercare la libreria per titolo: /discovery/cml/trending_list/ filtra i brani popolari per genere, paese e periodo.
  • Mantenere la musica in una bozza: upload_to_draft fa ignorare a TikTok il resto di post_info, e is_draft conserva solo il titolo e la didascalia.
  • Usare un brano proprio in un post organico: /file/music/upload/ aggiunge musica per i creativi pubblicitari sotto un advertiser_id, e l'avviso di TikTok lì lascia la responsabilità sul copyright a chi carica.

Quali sono le soluzioni alternative?

Tre, ognuna basata su ciò che documentano i riferimenti di TikTok, più un rischio da valutare:

  • Mixare la musica nel file. I vincoli di TikTok descrivono il video come contenuto audio-video, quindi una colonna sonora mixata esce con esso; usa audio di cui hai i diritti.
  • Inviare una bozza. Con upload_to_draft o is_draft e lo scope video.upload, il post arriva nella casella di TikTok del creator, da modificare e pubblicare nell'app.
  • Lasciare scegliere a TikTok nei post foto. auto_add_music aggiunge musica consigliata, e il proprietario può sostituirla in seguito nell'app TikTok.
  • Il rischio con l'audio mixato: l'elenco dei post di TikTok indica le violazioni del copyright musicale tra i motivi probabili per cui un post viene filtrato.

Come si vede se un suono ha portato visualizzazioni?

Tramite impression_sources, un campo di /business/video/list/ che classifica da dove sono arrivati gli spettatori di un post; uno dei suoi valori è Sound, per le visualizzazioni arrivate dalle pagine dei suoni. Richiede lo scope video.insights e, come gli altri conteggi, arriva con un ritardo da 24 a 48 ore. Tramite easyCoexistence, get_social_insights lo restituisce per uno dei 20 post più recenti dell'account quando impression_sources è indicato in metrics, con l'item_id del post come object_id.

Cosa fa easyCoexistence con la musica?

Pubblica il suono già presente nel tuo file. publish_tiktok_post, subito o con scheduled_at, invia la didascalia, il titolo di un post foto e l'impostazione dei commenti, senza music_sound_info e senza auto_add_music, quindi un video mantiene la sua colonna sonora e un post foto esce senza musica. Il tuo codice può inviare una POST a business/video/publish/ con music_sound_info e il token di get_social_credentials, ma quel corpo arriva a TikTok così com'è, video_url incluso, e TikTok recupera i media solo da domini o prefissi di URL verificati per l'app. I percorsi /discovery/ richiedono il token di un inserzionista, quindi l'elenco dei brani non è alla portata del token dell'account.

Errori comuni

  • Lasciare fuori video_original_sound_volume quando si aggiunge un brano. Tramite l'API è 0 per impostazione predefinita, mentre l'app TikTok parte con entrambi i suoni a 50, quindi impostalo ogni volta che l'audio originale del video conta.
  • Passare il nome di un brano o il suo preview_url come music_sound_id. Il riferimento di TikTok indica come valore da passare il song_clip_id, da full_duration_song_clip o trending_song_clip.
  • Chiamare /discovery/cml/trending_list/ con un token di inserzionista. Gli endpoint dei brani richiedono il token di un account TikTok e il business_id, come l'Accounts API.
  • Leggere una durata di 0 come un brano difettoso. TikTok precisa che un brano che è solo un estratto di un pezzo più lungo può mostrare 0, quindi controlla l'anteprima prima di scegliere inizio e fine.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Posso aggiungere qualsiasi brano a un post TikTok tramite l'API?

Brani della Commercial Music Library, tramite ID. La musica già mixata in un file video esce con il file, quindi deve essere musica di cui hai i diritti d'uso.

Quale volume imposta l'API di TikTok per la musica aggiunta?

0 per impostazione predefinita. music_sound_volume e video_original_sound_volume vanno da 0 a 100 e tramite l'API entrambi partono da 0, mentre l'app TikTok parte da 50, quindi impostali su ogni video con un brano.

La musica di un post conta se il post viene usato in seguito in un annuncio?

TikTok la controlla: /identity/music/authorization/ indica, per le località e le date di pubblicazione dell'annuncio, se la musica del post è completamente autorizzata, se manca l'autorizzazione o se non ha un ID brano.

Quante canzoni ci sono nella Commercial Music Library di TikTok?

1 milione, secondo il Centro assistenza business di TikTok, tutte già autorizzate per uso commerciale. /discovery/cml/trending_list/ ne restituisce fino a 100 popolari alla volta.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il