TikTokTikTok Popular Songs APITikTok Trending Sounds APITop 50Viral 50Classifiche musicali

TikTok Music Chart API: ottieni Top 50 e Viral 50

Crea una selezione di brani TikTok con le classifiche Top 50 e Viral 50 di SocQ. Ottieni ID dei suoni e conteggi di utilizzo, con esempi di richiesta ed esportazioni JSON e CSV.

SocQAggiornato il 16 ottobre 20266 min di lettura

Crea con SocQ la tua selezione di brani TikTok. Riunisci voci delle classifiche, ID dei suoni, artisti e conteggi di utilizzo nei video, poi collega ogni suono ai suoi dettagli e a video di esempio per ottenere un brief di contenuto basato su fonti.

La TikTok Popular Songs API di SocQ legge le classifiche Top 50 e Viral 50 dell’app TikTok. Questa guida tratta la scelta della classifica, le richieste, le esportazioni JSON e CSV e la ricerca dei video tramite l’ID del suono.

Risposta rapida: invia chart_type=top o chart_type=viral a POST /v1/tiktok/popular-songs. Salva l’ID attività restituito, attendi il successo e leggi data.results.items. L’impostazione predefinita è Top 50 con un limite di 20; results_limit accetta numeri interi da 1 a 50.

Scegli Top 50 o Viral 50

InputClassifica selezionataQuando usarla
chart_type: "top"Top 50 dell’app TikTokCrea un elenco da questa classifica specifica
chart_type: "viral"Viral 50 dell’app TikTokCrea un elenco Viral 50 o confronta i suoi ID dei suoni con la Top 50
Ometti chart_typeTop 50Usa la classifica predefinita

Quando raccogli entrambe le classifiche, salva chart_type insieme a ogni record. Conserva entrambe le osservazioni delle classifiche quando un suono compare in tutte e due le liste e usa audio.id per abbinare il suono tra l’una e l’altra.

chart_type seleziona la classifica e results_limit imposta il tetto di raccolta. Viral 50 è il nome di una classifica dell’app TikTok. Filtri per paese, filtri per data e misure di crescita sono trattati nelle FAQ qui sotto.

Richiedi la classifica dei brani

Imposta SOCQ_API_KEY nel tuo ambiente e invia la richiesta:

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}'

Cambia top in viral per selezionare Viral 50. Imposta results_limit a 50 per raccogliere fino a 50 voci da quella classifica; il valore result_count dell’attività indica il numero effettivo salvato.

La risposta all’invio contiene data.task_id. Assegna quel valore a TASK_ID, poi interroga l’attività esistente:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Attendi finché lo stato è queued, running o retrying. Leggi data.results.items dopo succeeded; controlla data.error_message dopo failed. Conserva l’ID attività quando una richiesta del client va in timeout, così potrai riprendere l’interrogazione.

results_limit imposta il tetto di raccolta. Nel recupero dell’attività, limit imposta la dimensione della pagina e cursor identifica la pagina salvata successiva. Il tetto di raccolta dei brani è di 50 voci.

Identifica il suono dietro ogni brano

Questo esempio di record di un brano mostra l’ID del suono, il titolo, l’artista, il conteggio di utilizzo nei video e l’orario di raccolta:

{
  "id": "6711980022204205826",
  "type": "music",
  "name": "we fell in love in october",
  "audio": {
    "id": "6711980022204205826",
    "title": "we fell in love in october",
    "artist": "girl in red"
  },
  "duration_seconds": 42,
  "metrics": {"videos_count": 2031150},
  "collected_at": "2026-10-15T08:12:54.524359Z"
}

Usa audio.id per le chiamate successive. Salvalo come stringa e importalo come testo negli strumenti per fogli di calcolo per conservare ogni cifra. L’abbinamento tramite ID del suono distingue suoni diversi che hanno lo stesso titolo.

metrics.videos_count è il totale riportato dei video che usano il suono. Null significa che la fonte ha omesso la misurazione; 0 è un conteggio restituito pari a zero. Per confrontare le rilevazioni, abbina gli ID dei suoni e calcola la differenza tra i due conteggi.

cover_url contiene l’indirizzo della copertina e audio.url l’indirizzo dell’audio. Quando audio.url è null, usa l’ID del suono, il titolo e l’artista per organizzare l’elenco. Controlla la risposta di un URL audio quando accedi al media.

Esporta un elenco di suoni in JSON e CSV con Python

Salva l’helper per le attività seguente come socq_collect.py. Usa la libreria standard di Python, stampa l’ID attività e legge ogni pagina di risultati salvata:

import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, urlopen

BASE = "https://api.socq.ai/v1"
PENDING = {"queued", "running", "retrying"}

def api(method, path, payload=None):
    body = json.dumps(payload).encode("utf-8") if payload is not None else None
    request = Request(
        BASE + path, data=body, method=method,
        headers={
            "Authorization": "Bearer " + os.environ["SOCQ_API_KEY"],
            "Content-Type": "application/json",
        },
    )
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("code") != 200:
        raise RuntimeError(result)
    return result["data"]

def collect(endpoint, payload):
    task_id = api("POST", "/" + endpoint, payload)["task_id"]
    print("Task:", task_id, flush=True)
    path = "/tasks/" + task_id
    deadline = time.monotonic() + 600
    data = api("GET", path + "?limit=100")
    while data["status"] in PENDING:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume GET " + path + "; do not resubmit automatically")
        time.sleep(2)
        data = api("GET", path + "?limit=100")
    if data["status"] != "succeeded":
        raise RuntimeError(data.get("error_message") or data["status"])

    items, seen_cursors = [], set()
    while True:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume pagination for " + task_id)
        page = data["results"]
        items.extend(page["items"])
        if not page["has_more"]:
            return task_id, items
        cursor = page.get("next_cursor")
        if not cursor or cursor in seen_cursors:
            raise RuntimeError("Missing or repeated result cursor")
        seen_cursors.add(cursor)
        data = api("GET", path + "?" + urlencode({"limit": 100, "cursor": cursor}))
        if data["status"] != "succeeded":
            raise RuntimeError("Task is not ready for result pagination")

Salva questa esportazione come export_songs.py nella stessa directory:

import csv
import json
import sys
from socq_collect import collect

chart = sys.argv[1] if len(sys.argv) > 1 else "top"
if chart not in {"top", "viral"}:
    raise SystemExit("Usage: python3 export_songs.py [top|viral]")
payload = {"chart_type": chart, "results_limit": 20}
task_id, items = collect("tiktok/popular-songs", payload)
with open(f"songs-{chart}.json", "w", encoding="utf-8") as f:
    json.dump({"task_id": task_id, "input": payload, "items": items},
              f, ensure_ascii=False, indent=2)

fields = ["chart_type", "sound_id", "title", "artist", "videos_count",
          "duration_seconds", "url", "collected_at"]
def csv_cell(value):
    if value is None:
        return ""
    if isinstance(value, str) and value.lstrip().startswith(("=", "+", "-", "@")):
        return "'" + value
    return value

with open(f"songs-{chart}.csv", "w", encoding="utf-8-sig", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=fields)
    writer.writeheader()
    for item in items:
        audio = item.get("audio") or {}
        row = {"chart_type": chart, "sound_id": audio.get("id"),
               "title": item.get("name"), "artist": audio.get("artist"),
               "videos_count": (item.get("metrics") or {}).get("videos_count"),
               "duration_seconds": item.get("duration_seconds"),
               "url": item.get("url"), "collected_at": item.get("collected_at")}
        writer.writerow({k: csv_cell(v) for k, v in row.items()})
python3 export_songs.py top
python3 export_songs.py viral

Ogni comando crea un’attività di raccolta separata. Il JSON conserva i record originali e la richiesta; il CSV è una tabella di revisione. Il testo pubblico simile a formule viene reso innocuo nel CSV, mentre il JSON mantiene i valori originali. Importa gli ID dei suoni come testo negli strumenti per fogli di calcolo.

Salva le esportazioni in base alla data di rilevazione. Confrontare metrics.videos_count dello stesso suono dà la differenza tra quelle due osservazioni. Etichetta un suono assente da una classifica successiva come “non osservato in questa rilevazione”; per indagare su una cancellazione, controlla separatamente il singolo suono.

Trova i video che usano un suono restituito

Scegli un suono dall’esportazione e passa il suo audio.id a TikTok Song Videos:

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":["6711980022204205826"],"results_limit":20}'

Questo crea un’attività di raccolta video separata, con il proprio results_limit. Usa TikTok Song per i dettagli del suono, oppure il tutorial sulla ricerca TikTok per analizzare un argomento tra video e post con immagini.

Per un brief di contenuto, conserva insieme ID del suono, tipo di classifica, orario di rilevazione, URL della fonte e video di esempio, così che chi revisiona possa verificare ogni elemento.

Metti le classifiche al lavoro nella tua ricerca musicale

SocQ collega il recupero delle classifiche, i dettagli dei suoni e la ricerca dei video correlati nello stesso flusso di attività. Usa il codice di esportazione per organizzare la ricerca per classifica e orario di rilevazione, poi aggiungi video di esempio a ogni suono. La tua prossima selezione parte da record che puoi rivedere e riutilizzare.

Apri la Popular Songs API e crea la tua selezione.

Domande frequenti (FAQ)

È una API per i suoni di tendenza di TikTok?

Sì. Il suo ambito sono le classifiche Top 50 e Viral 50 dell’app TikTok. Seleziona una classifica con chart_type e organizza i suoni restituiti per ID.

Posso scegliere un paese o un intervallo di date?

La raccolta è organizzata per tipo di classifica. Gli input supportati sono chart_type, results_limit e callback_url facoltativo per il completamento dell’attività. Filtri per paese, data, nuove voci e musica commerciale non sono previsti.

Posso ottenere più di 50 brani con la paginazione?

Ogni attività raccoglie fino a 50 voci. La paginazione dei risultati legge i brani già salvati da quell’attività.

Viral 50 include un punteggio di crescita o la variazione di posizione?

Il record standard fornisce informazioni sul suono e conteggi di utilizzo nei video; punteggi di crescita e variazioni di posizione non sono inclusi. Salva rilevazioni ripetute e calcola le differenze per ID del suono quando confronti le osservazioni.

L’ID di un suono identifica ogni registrazione dello stesso brano?

Un ID del suono identifica un singolo suono di TikTok. Salva clip o versioni separate con i rispettivi ID, anche quando condividono il titolo del brano.

Posso scaricare ogni brano o filtrare la musica approvata per uso aziendale?

Quando audio.url ha un valore, prova quell’indirizzo per accedere all’audio. Quando è null, conserva l’ID del suono per una consultazione dei dettagli. L’idoneità all’uso commerciale richiede una verifica separata; questo endpoint non fornisce né un campo di approvazione né un filtro corrispondente.

Come ottengo i video che usano uno dei brani?

Invia l’audio.id restituito nell’array music_ids a TikTok Song Videos. È un’attività separata, con il proprio limite di raccolta e la propria fatturazione. Consulta la pagina della Popular Songs API per i dettagli attuali su input e fatturazione.

TIKTOK API

Prova il flusso di lavoro con un URL pubblico di TikTok

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di TikTok