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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
music_ids | Obbligatorio | Array di ID numerici di clip sonore TikTok per cui raccogliere i video pubblici. |
results_limit | Facoltativo | Numero 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.
- Fornisci un array di ID numerici di clip in music_ids e un results_limit facoltativo fino a 2.000.
- Invia una richiesta POST a /v1/tiktok/song-videos con la tua chiave API SocQ.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- 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.
API correlate
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API