tiktok/
popular-songs

Ottieni la classifica dei brani TikTok Top 50 o Viral 50, con titoli dei brani, artisti, ID dei sound e numero di video disponibile, per costruire un elenco musicale da esaminare.

TikTok Popular Songs API

Top 50
Viral 50
ID dei sound
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
chart_typeFacoltativoScelta 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_limitFacoltativoNumero 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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Esplora altre piattaforme

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

TikTok Popular Songs API — FAQ

TikTok Popular Songs API è un’interfaccia programmatica per leggere la classifica di brani Top 50 o Viral 50 dell’app TikTok. Scegli chart_type e un limite di risultati per ottenere nomi dei sound, artisti, ID dei sound, copertine, durate e numero di video che li usano, se disponibile.

Selezionano due classifiche con un nome preciso dell’app TikTok: top è Top 50 e viral è Viral 50. Se chart_type viene omesso, l’API usa top. La risposta non spiega la formula della classifica né fornisce un punteggio di crescita.

No. Questa interfaccia accetta chart_type e results_limit, più un callback_url facoltativo per il completamento dell’attività. Non offre filtri per paese, periodo della classifica, nuove entrate o musica commerciale.

No. results_limit è compreso tra 1 e 50. Un cursore dei risultati ti permette di leggere un’altra pagina di record già salvati da quell’attività; non raccoglie voci aggiuntive della classifica.

metrics.videos_count è il numero di video segnalati come usanti il sound. Non misura ascoltatori, visualizzazioni o Mi piace. Un conteggio null significa che la fonte non ha fornito quella misura, mentre zero è un valore effettivamente restituito.

Prendi audio.id dal record del brano e passalo in music_ids a TikTok Song Videos. Per recuperare i dettagli di un singolo sound, usa quell’ID con TikTok Song. Sono richieste separate.

No. audio.url può essere null anche quando nome, artista e ID del sound sono disponibili. Quando viene restituito un URL, puoi usarlo per ispezionare l’audio disponibile; l’API non garantisce che il link resti accessibile.

Ogni record di brano restituito costa 0,5 crediti, senza costo base. Un limite di 20 stima 10 crediti; se l’attività restituisce 12 brani, l’addebito finale è di 6 crediti. Un limite di 50 stima 25 crediti.