TikTokTikTok Popular Songs APITikTok Trending Sounds APITop 50Viral 50Musikcharts

TikTok Music Chart API: Top 50 und Viral 50 abrufen

Erstellen Sie mit den SocQ-Charts Top 50 und Viral 50 eine TikTok-Songauswahl. Sound-IDs und Nutzungszahlen mit Anfragebeispielen sowie JSON- und CSV-Export.

SocQAktualisiert am 16. Oktober 20266 Min. Lesezeit

Erstellen Sie Ihre TikTok-Songauswahl mit SocQ. Führen Sie Chart-Einträge, Sound-IDs, Interpreten und Video-Nutzungszahlen zusammen und verknüpfen Sie dann jeden Sound mit seinen Details und Beispielvideos zu einem belegbaren Content-Briefing.

Die SocQ TikTok Popular Songs API liest die Charts Top 50 und Viral 50 der TikTok-App. Dieser Leitfaden behandelt die Chart-Auswahl, Anfragen, JSON- und CSV-Exporte sowie die Videosuche anhand der Sound-ID.

Kurzantwort: Senden Sie chart_type=top oder chart_type=viral an POST /v1/tiktok/popular-songs. Speichern Sie die zurückgegebene Aufgaben-ID, warten Sie auf den Erfolg und lesen Sie data.results.items. Standard ist Top 50 mit einem Limit von 20; results_limit akzeptiert ganze Zahlen von 1 bis 50.

Top 50 oder Viral 50 wählen

EingabeGewähltes ChartWann es sich eignet
chart_type: "top"Top 50 der TikTok-AppEine Liste aus diesem benannten Chart erstellen
chart_type: "viral"Viral 50 der TikTok-AppEine Viral-50-Liste erstellen oder deren Sound-IDs mit Top 50 vergleichen
chart_type weglassenTop 50Das Standard-Chart verwenden

Wenn Sie beide Charts erfassen, speichern Sie chart_type zu jedem Datensatz. Behalten Sie beide Chart-Beobachtungen, wenn ein Sound in beiden Listen vorkommt, und gleichen Sie den Sound über audio.id ab.

chart_type wählt das Chart, und results_limit legt die Obergrenze der Erfassung fest. Viral 50 ist der Name eines Charts in der TikTok-App. Länderfilter, Datumsfilter und Wachstumskennzahlen werden in den FAQ weiter unten behandelt.

Das Songs-Chart abfragen

Setzen Sie SOCQ_API_KEY in Ihrer Umgebung und senden Sie die Anfrage ab:

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

Ändern Sie top in viral, um Viral 50 zu wählen. Setzen Sie results_limit auf 50, um bis zu 50 Einträge dieses Charts zu erfassen; result_count der Aufgabe nennt die tatsächlich gespeicherte Anzahl.

Die Antwort auf die Übermittlung enthält data.task_id. Weisen Sie diesen Wert TASK_ID zu und fragen Sie dann die bestehende Aufgabe ab:

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

Warten Sie, solange der Status queued, running oder retrying lautet. Lesen Sie nach succeeded die Daten unter data.results.items; prüfen Sie nach failed den Wert data.error_message. Bewahren Sie eine Aufgaben-ID auf, wenn bei einer Client-Anfrage eine Zeitüberschreitung auftritt, damit Sie die Abfrage fortsetzen können.

results_limit legt die Obergrenze der Erfassung fest. Beim Abruf der Aufgabe bestimmt limit die Seitengröße, und cursor kennzeichnet die nächste gespeicherte Seite. Die Obergrenze für die Songs-Erfassung liegt bei 50 Einträgen.

Den Sound hinter jedem Song identifizieren

Dieses Beispiel eines Song-Datensatzes zeigt Sound-ID, Titel, Interpret, Anzahl der Videos mit dem Sound und Erfassungszeit:

{
  "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"
}

Verwenden Sie audio.id für Folgeaufrufe. Speichern Sie die ID als Zeichenkette und importieren Sie sie in Tabellenkalkulationen als Text, damit jede Ziffer erhalten bleibt. Der Abgleich über die Sound-ID unterscheidet getrennte Sounds, die denselben Titel tragen.

metrics.videos_count ist die gemeldete Gesamtzahl der Videos, die den Sound verwenden. Null bedeutet, dass die Quelle den Messwert ausgelassen hat; 0 ist ein zurückgegebener Zählerstand von null. Um Erfassungen zu vergleichen, gleichen Sie die Sound-IDs ab und berechnen die Differenz der beiden Zählerstände.

cover_url enthält die Adresse des Covers und audio.url die Adresse der Audiodatei. Ist audio.url null, ordnen Sie die Liste anhand von Sound-ID, Titel und Interpret. Prüfen Sie beim Zugriff auf die Medien die Antwort einer Audio-URL.

Eine Sound-Liste mit Python als JSON und CSV exportieren

Speichern Sie den folgenden Aufgaben-Helfer als socq_collect.py. Er verwendet die Standardbibliothek von Python, gibt die Aufgaben-ID aus und liest jede gespeicherte Ergebnisseite:

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")

Speichern Sie diesen Export als export_songs.py im selben Verzeichnis:

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

Jeder Befehl erstellt eine eigene Erfassungsaufgabe. Das JSON behält die ursprünglichen Datensätze und die Anfrage; die CSV-Datei ist eine Tabelle zur Durchsicht. Öffentlicher Text, der wie eine Formel aussieht, wird in der CSV-Datei maskiert, während das JSON die Originalwerte behält. Importieren Sie Sound-IDs in Tabellenkalkulationen als Text.

Speichern Sie Exporte nach Erfassungsdatum. Der Vergleich von metrics.videos_count desselben Sounds ergibt eine Differenz zwischen diesen beiden Beobachtungen. Kennzeichnen Sie einen Sound, der in einem späteren Chart fehlt, als „in dieser Erfassung nicht beobachtet“; prüfen Sie den einzelnen Sound separat, um eine Löschung zu untersuchen.

Videos finden, die einen zurückgegebenen Sound verwenden

Wählen Sie einen Sound aus dem Export und übergeben Sie dessen audio.id an 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}'

Das erzeugt eine eigene Aufgabe zur Videoerfassung mit eigenem results_limit. Verwenden Sie TikTok Song für Details zu einem Sound oder die TikTok-Suchanleitung, um ein Thema über Videos und Bildbeiträge hinweg zu recherchieren.

Für ein Content-Briefing sollten Sie Sound-ID, Chart-Typ, Erfassungszeit, Quell-URL und Beispielvideos zusammenhalten, damit eine prüfende Person jeden Eintrag nachvollziehen kann.

Die Charts in Ihrer Musikrecherche einsetzen

SocQ verbindet Chart-Abruf, Sound-Details und die Suche nach zugehörigen Videos im selben Aufgaben-Workflow. Ordnen Sie Ihre Recherche mit dem Export-Code nach Chart und Erfassungszeit und ergänzen Sie dann zu jedem Sound Videobeispiele. Ihre nächste Auswahl beginnt mit Datensätzen, die Sie prüfen und wiederverwenden können.

Popular Songs API öffnen und Ihre Auswahl erstellen.

Häufig gestellte Fragen (FAQ)

Ist das eine API für TikTok-Trend-Sounds?

Ja. Der Umfang umfasst die Charts Top 50 und Viral 50 der TikTok-App. Wählen Sie ein Chart mit chart_type und ordnen Sie die zurückgegebenen Sounds nach ID.

Kann ich ein Land oder einen Zeitraum wählen?

Die Erfassung ist nach Chart-Typ organisiert. Unterstützte Eingaben sind chart_type, results_limit und die optionale callback_url für den Abschluss der Aufgabe. Filter nach Land, Datum, Neueinsteigern und kommerzieller Musik gibt es nicht.

Kann ich per Paginierung mehr als 50 Songs erhalten?

Jede Aufgabe erfasst bis zu 50 Einträge. Die Paginierung der Ergebnisse liest die Songs, die diese Aufgabe bereits gespeichert hat.

Enthält Viral 50 einen Wachstumswert oder eine Rangänderung?

Der Standard-Datensatz enthält Sound-Informationen und Video-Nutzungszahlen; Wachstumswerte und Rangänderungen sind nicht enthalten. Speichern Sie wiederholte Erfassungen und berechnen Sie beim Vergleich der Beobachtungen die Differenzen pro Sound-ID.

Identifiziert eine Sound-ID jede Aufnahme desselben Songs?

Eine Sound-ID identifiziert genau einen TikTok-Sound. Speichern Sie getrennte Clips oder Versionen unter ihren eigenen IDs, auch wenn sie denselben Songtitel haben.

Kann ich jeden Song herunterladen oder nach geschäftlich freigegebener Musik filtern?

Hat audio.url einen Wert, versuchen Sie über diese Adresse auf die Audiodatei zuzugreifen. Ist der Wert null, behalten Sie die Sound-ID für eine Detailabfrage. Ob eine kommerzielle Nutzung zulässig ist, erfordert eine separate Prüfung; dieser Endpunkt bietet weder ein Freigabefeld noch einen entsprechenden Filter.

Wie erhalte ich Videos, die einen der Songs verwenden?

Senden Sie die zurückgegebene audio.id im Array music_ids an TikTok Song Videos. Das ist eine eigene Aufgabe mit eigenem Erfassungslimit und eigener Abrechnung. Aktuelle Angaben zu Eingaben und Abrechnung finden Sie auf der Seite zur Popular Songs API.

TIKTOK API

Workflow mit einer öffentlichen TikTok-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

TikTok-APIs ansehen