tiktok/
popular-songs

Rufen Sie die TikTok-Song-Charts Top 50 oder Viral 50 ab, mit Titeln, Interpreten, Sound-IDs und verfügbaren Video-Anzahlen, um eine Musikliste zur Sichtung aufzubauen.

TikTok Popular Songs API

Top 50
Viral 50
Sound-IDs
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

TikTok Popular Songs

Ein TikTok-Sound ist die Audiospur, die einem Beitrag zugeordnet ist, und die TikTok-App bietet die Song-Charts Top 50 und Viral 50. Jeder zurückgegebene Datensatz identifiziert einen bestimmten Sound mit Titel, Interpret und Sound-ID, sodass Sie eine Musikliste aufbauen und jeden Eintrag mit Sound-Details oder den Videos verknüpfen können, die ihn verwenden.

Funktionen der TikTok Popular Songs API

  • Eines von zwei Song-Charts wählenSetzen Sie chart_type auf top für Top 50 oder auf viral für Viral 50. Das sind zwei benannte Charts in der TikTok-App; wählen Sie das Chart, das Sie sichten möchten, und fordern Sie bis zu 50 Einträge an.
  • Den genauen Sound hinter einem Songtitel identifizierenLesen Sie Titel, Interpret, Sound-ID, Cover und Dauer zusammen aus. Die Sound-ID unterscheidet Audioclips mit demselben Namen und ermöglicht es, genau diesen Sound mit TikTok Song oder TikTok Song Videos abzufragen.
  • Verfügbare Nutzungszahlen eines Sounds lesenWenn die Quelle eine Zahl liefert, gibt metrics.videos_count an, wie viele Videos diesen Sound verwenden. Es ist eine Anzahl von Videos, keine Anzahl von Hörern, Wiedergaben oder Likes; eine nicht verfügbare Zahl bleibt null.

Parameter der TikTok Popular Songs API

ParameterErforderlichBeschreibung
chart_typeOptionalOptionale Chart-Auswahl: top wählt die Top 50 der TikTok-App, viral wählt Viral 50. Standard ist top. Ändern Sie zum Beispiel den Beispielwert auf viral, um das andere Chart anzufordern.
results_limitOptionalOptionale maximale Anzahl an Songs, eine ganze Zahl von 1 bis 50; Standard ist 20. Mit 10 fordern Sie zum Beispiel bis zu zehn Einträge des gewählten Charts an. Die Quelle kann weniger liefern, und die Paginierung der Ergebnisse erweitert dieses Limit nicht.

So verwenden Sie die TikTok Popular Songs API

Die Anfrage startet eine Aufgabe, die im Hintergrund Daten sammelt. Die erste Antwort enthält daher eine Aufgaben-ID statt der fertigen Daten; mit dieser ID prüfen Sie den Fortschritt und rufen die Ergebnisse ab.

  1. Wählen Sie chart_type: top für Top 50 oder viral für Viral 50. Wenn Sie den Parameter weglassen, verwendet die API top; results_limit ist standardmäßig 20 und akzeptiert eine ganze Zahl von 1 bis 50.
  2. Ersetzen Sie $SOCQ_API_KEY durch Ihren API-Schlüssel oder setzen Sie diese Umgebungsvariable. Senden Sie die JSON-Anfrage mit dem Header Authorization per POST an /v1/tiktok/popular-songs und speichern Sie die zurückgegebene task_id.
  3. Die erste Antwort enthält eine Aufgaben-ID, weil die Datenerfassung im Hintergrund läuft. Fragen Sie GET /v1/tasks/{task_id} ab; queued, running und retrying bedeuten, dass die Aufgabe noch läuft. Lesen Sie die Ergebnisse nach succeeded oder prüfen Sie nach failed die error_message.
  4. Lesen Sie data.results.items. Jedes Element beschreibt einen bestimmten Sound; audio.id ist seine Sound-ID, audio.artist nennt den Interpreten und metrics.videos_count ist die verfügbare Anzahl der Videos, die den Sound verwenden. Ein leeres Array items bedeutet, dass keine Datensätze zurückgegeben wurden.
  5. Wenn data.results.has_more den Wert true hat, übergeben Sie next_cursor unverändert als cursor an GET /v1/tasks/{task_id}?cursor=... und fahren Sie fort, bis has_more false ist. So lesen Sie eine weitere Seite derselben gespeicherten Aufgabe; das Erfassungslimit des Charts von 50 Einträgen wird dadurch nicht erhöht.
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}'

Anwendungsfälle der TikTok Popular Songs API

  • Eine Musik-Sichtungsliste vorbereiten: Wählen Sie Top 50 oder Viral 50 und exportieren Sie Titel, Interpreten, Sound-IDs, Dauer und verfügbare Video-Anzahlen in eine Tabelle. Ihr Team kann die Sound-Seiten öffnen und prüfen, welche Clips zu einer Content-Idee passen.
  • Beispiele für Videos mit einem Sound sammeln: Übergeben Sie zurückgegebene Sound-IDs als music_ids an TikTok Song Videos, um öffentliche Beispielvideos zu sammeln. Prüfen Sie diese Videos selbst, um zu verstehen, wie ein Clip verwendet wird; diese Chart-Schnittstelle führt keine solche Analyse durch.
  • Getrennt erfasste Chart-Momentaufnahmen vergleichen: Speichern Sie bei jeder Aufgabe das gewählte chart_type, die Sound-IDs, die verfügbaren Video-Anzahlen und collected_at. Verknüpfen Sie Ihre gespeicherten Tabellen über die Sound-ID, um zurückgegebene Songs und Nutzungszahlen im Zeitverlauf zu vergleichen; historische Platzierungen liefert die API selbst nicht.

Profi-Tipps zur TikTok Popular Songs API

  • Halten Sie chart_type konstant, wenn Sie gespeicherte Abrufe vergleichen. Der Wechsel von top zu viral ändert das gewählte Chart, sodass eine andere Songliste für sich genommen keinen Anstieg oder Rückgang der Beliebtheit belegt.
  • Verwenden Sie audio.id, um Datensätze über Aufgaben hinweg zu verknüpfen und um TikTok Song oder TikTok Song Videos anzufragen. Ein Titel allein kann verschiedene Sound-Clips mit gleichem Namen nicht unterscheiden.
  • Wenn audio.url null ist, behalten Sie die Sound-ID und die URL der öffentlichen Sound-Seite für weitere Recherchen. Ist eine Audio-URL angegeben, behandeln Sie sie als Medienlink, der zum Zeitpunkt der Erfassung verfügbar war, und nicht als dauerhafte Download-Adresse.

Ergänzend zur TikTok Popular Songs API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
  • TikTok Trending Feed API — Den aktuellen öffentlichen Video-Feed einer Region erfassen – mit Feldern zu Creator, Bildunterschrift, Cover, Zeitstempel und sichtbaren Interaktionen.
  • TikTok Video Transcript API — Verfügbaren Transkripttext, Sprache, Format und Quellkontext aus öffentlichen Video-URLs extrahieren.
  • TikTok Song API — Öffentliche Sound-Metadaten per Clip-ID oder Musik-URL abrufen.
  • TikTok Song Videos API — Öffentliche Videos zu angegebenen Sound-IDs erfassen.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Popular Songs API — FAQ

TikTok Popular Songs API ist eine Schnittstelle zum Auslesen des Song-Charts Top 50 oder Viral 50 der TikTok-App. Wählen Sie chart_type und ein Ergebnislimit, um Sound-Namen, Interpreten, Sound-IDs, Cover, Dauer und verfügbare Video-Nutzungszahlen zu erhalten.

Sie wählen zwei benannte Charts der TikTok-App: top ist Top 50 und viral ist Viral 50. Wenn chart_type fehlt, verwendet die API top. Die Antwort erklärt weder die Ranking-Formel noch liefert sie einen Wachstumswert.

Nein. Diese Schnittstelle akzeptiert chart_type und results_limit sowie eine optionale callback_url für den Abschluss der Aufgabe. Filter für Land, Chart-Zeitraum, Neueinsteiger oder kommerzielle Musik gibt es nicht.

Nein. results_limit liegt zwischen 1 und 50. Mit einem Ergebnis-Cursor lesen Sie eine weitere Seite der Datensätze, die diese Aufgabe bereits gespeichert hat; zusätzliche Chart-Einträge werden dadurch nicht erfasst.

metrics.videos_count ist die Anzahl der Videos, die als Verwender des Sounds gemeldet werden. Sie misst weder Hörer noch Aufrufe oder Likes. Ein Wert null bedeutet, dass die Quelle diese Messung nicht geliefert hat, während 0 ein tatsächlich zurückgegebener Wert ist.

Nehmen Sie audio.id aus dem Song-Datensatz und übergeben Sie sie in music_ids an TikTok Song Videos. Um die Details eines Sounds abzurufen, verwenden Sie diese ID mit TikTok Song. Das sind getrennte Anfragen.

Nein. audio.url kann null sein, auch wenn Name, Interpret und Sound-ID vorliegen. Wird eine URL zurückgegeben, können Sie damit das verfügbare Audio prüfen; die API garantiert nicht, dass der Link erreichbar bleibt.

Jeder zurückgegebene Song-Datensatz kostet 0,5 Credits, ohne Grundgebühr. Ein Limit von 20 ergibt geschätzt 10 Credits; liefert die Aufgabe 12 Songs, beträgt die endgültige Abrechnung 6 Credits. Ein Limit von 50 ergibt geschätzt 25 Credits.