tiktok/
song-videos

Raccogli i video TikTok pubblici che usano un sound specifico, con metadati normalizzati dei video, dettagli del creator, didascalie, link ai media e contatori di engagement.

TikTok Song Videos API

Video collegati all’audio
Challenge sui sound
Raggruppamento delle tendenze
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Song Videos

Seguire i post video collegati a una traccia audio condivisa rivela come i creator interpretano le challenge virali e la musica di sottofondo di tendenza. Gli elementi video normalizzati restituiscono contesto del creator, didascalie, link di riproduzione e metriche visibili di engagement per ogni gruppo di sound.

Funzionalità della TikTok Song Videos API

  • Raccolta di video centrata sul soundInvia uno o più ID numerici di clip sonore per raccogliere i video pubblicati con quell’identità audio esatta.
  • Contesto del creator e del postAcquisisci per ogni video restituito nome utente e nickname del creator, testo completo della didascalia, hashtag e menzioni.
  • Dettaglio dell’engagementEstrai il numero di visualizzazioni, Mi piace, commenti, condivisioni e salvataggi per confrontare le prestazioni dei video che usano la stessa traccia.
  • Link per scaricare i mediaRicevi URL diretti dell’immagine di copertina e dello stream video, con metadati su dimensioni e durata.

Parametri della TikTok Song Videos API

ParametriObbligatorioDescrizione
music_idsObbligatorioArray di ID numerici di clip sonore TikTok per cui raccogliere i video pubblici.
results_limitFacoltativoNumero massimo di video da restituire per ogni ID del sound; il valore predefinito è 100, con un intervallo consentito da 1 a 2.000.

Come usare la TikTok Song Videos API

Invia un elenco di ID di clip sonore come attività asincrona, poi scorri con la paginazione i risultati video normalizzati.

  1. Fornisci un array di ID numerici di clip in music_ids e un results_limit facoltativo fino a 2.000.
  2. Invia una richiesta POST a /v1/tiktok/song-videos con la tua chiave API SocQ.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. Leggi data.results.items e segui next_cursor per le pagine successive.
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"music_ids":["7439295283975702544"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Casi d’uso della TikTok Song Videos API

  • Analisi di campagne con sound virali: Valuta con quanta efficacia un sound di brand o una traccia audio promozionale si sta diffondendo tra le community di creator.
  • Ricerca sui modelli creativi: Analizza i formati visivi, le coreografie o gli sketch più comuni adottati dai creator che usano lo stesso frammento audio.
  • Scoperta di UGC ad alte prestazioni: Individua i video generati dagli utenti con le migliori prestazioni associati a una specifica musica di tendenza, per licenze o collaborazioni.

Consigli degli esperti per la TikTok Song Videos API

  • Ottieni il music_id numerico dall’endpoint TikTok Song o dalla parte finale di un URL web di una musica TikTok.
  • I risultati vengono restituiti in ordine cronologico inverso o per popolarità, in base ai feed dei sound della piattaforma.
  • Usa results_limit per limitare i risultati per sound; le attività con più ID paginano ogni ID del sound in modo indipendente.
  • Controlla extra.clip_id in ogni elemento video per ricollegare gli elementi all’ID del sound di input.

Oltre alla TikTok Song Videos API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
  • TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
  • TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • TikTok Trending Feed API — Raccoglie il feed video pubblico attuale di una regione con creator, didascalia, copertina, data ed engagement visibile.
  • TikTok Video Transcript API — Estrae, quando disponibili, il testo della trascrizione, la lingua, il formato e il contesto della fonte dagli URL dei video pubblici.
  • TikTok Song API — Recupera i metadati di un suono pubblico tramite ID della clip o URL del brano.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Song Videos API — FAQ

TikTok Song Videos API raccoglie i video pubblici che usano uno specifico sound TikTok o ID di una clip musicale. Restituisce post video normalizzati, dettagli degli autori, didascalie, link ai media e metriche visibili di engagement, per l’analisi di tendenze e challenge.

music_ids accetta un array di ID numerici di clip in formato stringa, come ["7439295283975702544"], presenti nelle pagine dei sound di TikTok.

Sì. Puoi fornire un array con più ID di clip; ogni sound verrà elaborato e restituito nell’output aggregato dell’attività.