TikTok Popular Songs
Un sound di TikTok è l’audio collegato a un post, e l’app TikTok offre le classifiche di brani Top 50 e Viral 50. Ogni record restituito identifica un sound specifico con titolo, artista e ID del sound, così puoi costruire un elenco musicale e collegare ogni voce ai dettagli del sound o ai video che lo usano.
Funzionalità della TikTok Popular Songs API
- Scegli una delle due classifiche di braniImposta chart_type su top per Top 50 o su viral per Viral 50. Sono due classifiche con un nome preciso nell’app TikTok; scegli quella che vuoi esaminare e richiedi fino a 50 voci.
- Identifica il sound esatto dietro il titolo di un branoLeggi insieme titolo, artista, ID del sound, copertina e durata. L’ID del sound aiuta a distinguere clip audio con lo stesso nome e ti permette di cercare quel sound specifico con TikTok Song o TikTok Song Videos.
- Leggi il numero di utilizzi del sound, se disponibileQuando la fonte fornisce un conteggio, metrics.videos_count indica quanti video usano quel sound. È un numero di video, non di ascoltatori, riproduzioni o Mi piace; un conteggio non disponibile resta null.
Parametri della TikTok Popular Songs API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
chart_type | Facoltativo | Scelta facoltativa della classifica: top seleziona la Top 50 dell’app TikTok; viral seleziona Viral 50. Il valore predefinito è top. Per esempio, cambia il valore dell’esempio in viral per richiedere l’altra classifica. |
results_limit | Facoltativo | Numero massimo facoltativo di brani, un numero intero da 1 a 50; il valore predefinito è 20. Per esempio, 10 richiede fino a dieci voci dalla classifica selezionata. La fonte può restituirne meno e la paginazione dei risultati non amplia questo limite. |
Come usare la TikTok Popular Songs API
La richiesta avvia un’attività di raccolta in background, quindi la prima risposta contiene un ID attività e non i dati completi; usa quell’ID per controllare l’avanzamento e recuperare i risultati.
- Scegli chart_type: top per Top 50 o viral per Viral 50. Se lo ometti, l’API usa top; results_limit ha come valore predefinito 20 e accetta un numero intero da 1 a 50.
- Sostituisci $SOCQ_API_KEY con la tua chiave API, oppure imposta quella variabile d’ambiente. Invia la richiesta JSON a POST /v1/tiktok/popular-songs con l’intestazione Authorization, poi salva il task_id restituito.
- La prima risposta contiene un ID attività perché la raccolta viene eseguita in background. Interroga GET /v1/tasks/{task_id}; queued, running e retrying indicano che l’attività è ancora in corso. Leggi i risultati dopo succeeded oppure controlla error_message dopo failed.
- Leggi data.results.items. Ogni elemento descrive un sound specifico; audio.id è il suo ID del sound, audio.artist indica l’artista e metrics.videos_count è il numero di video che lo usano, se disponibile. Un array items vuoto significa che non sono stati restituiti record.
- Se data.results.has_more è true, passa next_cursor invariato come cursor a GET /v1/tasks/{task_id}?cursor=... e continua finché has_more è false. Questo legge un’altra pagina della stessa attività salvata; non aumenta oltre 50 il limite di raccolta della classifica.
curl -X POST "https://api.socq.ai/v1/tiktok/popular-songs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"chart_type":"top","results_limit":20}'Casi d’uso della TikTok Popular Songs API
- Preparare un foglio di revisione musicale: Scegli Top 50 o Viral 50, poi esporta in una tabella titoli, artisti, ID dei sound, durate e numero di video disponibile. Il tuo team può aprire le pagine dei sound ed esaminare quali clip si adattano a un’idea di contenuto.
- Raccogliere esempi di video che usano un sound: Passa gli ID dei sound restituiti come music_ids a TikTok Song Videos per raccogliere esempi di video pubblici. Esamina tu stesso quei video per capire come viene usata una clip; questa API di classifica non esegue quell’analisi.
- Confrontare istantanee di classifica raccolte separatamente: Salva chart_type selezionato, ID dei sound, numero di video disponibile e collected_at a ogni esecuzione di un’attività. Unisci le tabelle salvate per ID del sound per confrontare nel tempo i brani restituiti e il numero di utilizzi; l’API stessa non fornisce classifiche storiche.
Consigli degli esperti per la TikTok Popular Songs API
- Mantieni coerente chart_type quando confronti esecuzioni salvate. Passare da top a viral cambia la classifica selezionata, quindi un elenco di brani diverso non dimostra da solo un aumento o un calo di popolarità.
- Usa audio.id per collegare i record tra le attività e per richiedere TikTok Song o TikTok Song Videos. Il solo titolo non permette di distinguere clip audio diverse con lo stesso nome.
- Se audio.url è null, conserva l’ID del sound e l’URL pubblico della pagina del sound per ulteriori ricerche. Quando viene fornito un URL audio, consideralo un link ai media disponibile al momento della raccolta e non un indirizzo di download permanente.
API correlate
Oltre alla TikTok Popular Songs API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.
- 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 Song Videos API — Raccoglie i video pubblici che usano gli ID dei suoni indicati.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Comments 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 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