tiktok/
live-ranking

Die tägliche LIVE-Rangliste der Creator von TikTok in einem Aufruf abrufen: bis zu 99 Hosts mit Platz, geschenkebasiertem Wert, Nutzer-ID, Handle, Anzeigename, Follower-Zahl und Profillink.

TikTok Live Ranking API

Keine Eingabe nötig
Bis zu 99 Hosts
Wert aus Geschenken
0,5 Credits pro Anfrage
Bereit
Bereit

Senden Sie die leere Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Live Ranking

Das tägliche LIVE-Ranking von TikTok ist die Tagesrangliste der Live-Hosts, geordnet nach einem Wert, der aus den Geschenken stammt, die Zuschauer während der Übertragungen senden; jeder Eintrag zeigt Platz, Wert und Follower-Zahl des Hosts. Wer es liest, sieht, welche Hosts die Zuschauer heute unterstützen, wie sich die vorderen Plätze verschieben und welche kleineren Accounts mehr Zuspruch bekommen, als ihre Größe erwarten lässt.

Funktionen der TikTok Live Ranking API

  • Die ganze Rangliste, ohne ParameterEine Anfrage braucht keine Eingabe und liefert das aktuelle Tagesranking mit bis zu 99 Hosts, jeder mit seinem rank.
  • Wert neben der Größe des Publikumsscore ist der Rangwert aus den Geschenken und followers_count die Follower-Zahl des Hosts, sodass sich Unterstützung und Publikum ohne zweite Abfrage vergleichen lassen.
  • Identität des Hosts in jeder Zeileauthor enthält Nutzer-ID, Handle, Anzeigename, Profillink und Avatar des Hosts.

Parameter der TikTok Live Ranking API

Bereit zum Senden

Dieser Endpunkt benötigt keine Anfrageparameter. Senden Sie das leere JSON-Objekt unverändert.

{}

So verwenden Sie die TikTok Live Ranking API

Senden Sie eine leere Anfrage und lesen Sie die gelisteten Hosts aus.

  1. Senden Sie {} per POST an /v1/tiktok/live-ranking.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Hosts aus results.items und geben Sie results.next_cursor zurück, solange has_more true ist.
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Each item has rank, score, author and followers_count.

Anwendungsfälle der TikTok Live Ranking API

  • Die Rangliste im Tagesverlauf verfolgen: Rufen Sie das Ranking zu festen Uhrzeiten ab und tragen Sie rank und score jedes Hosts auf, um zu sehen, wer aufsteigt und wann sich die Reihenfolge ändert.
  • Hosts für Agenturen und Sponsoren finden: Teilen Sie score durch followers_count, um Hosts zu finden, deren Zuschauer im Verhältnis zur Publikumsgröße viel geben, und nehmen Sie sie für Verträge oder Sponsoring in die engere Wahl.

Profi-Tipps zur TikTok Live Ranking API

  • Legen Sie die Abrufe jeden Tag auf dieselbe Uhrzeit, denn ein Wert von mittags und einer von Mitternacht decken unterschiedliche Teile desselben Tages ab.
  • Das Ranking enthält keinen Live-Status. Ordnen Sie Hosts über author.id zu und senden Sie ihre Benutzernamen an TikTok User Live, um zu sehen, wer gerade sendet.

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

  • TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
  • TikTok Followers List API — Normalisierte Profile aus öffentlichen Follower-Listen erfassen – mit erhaltenem Quellkontext und unterstützten Kennzahlen.
  • TikTok Following List API — Öffentliche Profile erfassen, denen TikTok-Konten folgen – mit normalisierter Identität, Bios, sichtbaren Kennzahlen und Kontext des Quellkontos.
  • TikTok User Live API — Benutzernamen auf Live- oder Offline-Status prüfen und verfügbare Details zum Livestream abrufen.
  • TikTok Audience Demographics API — Per Benutzername sehen, aus welchen Ländern die Follower eines Creators stammen – mit dem Anteil jedes Landes an der Zielgruppe.
  • TikTok Live Search API — Gerade laufende LIVE-Streams per Keyword finden – mit Hosts, Titeln und aktuellen Zuschauern.

Weitere Plattformen entdecken

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

TikTok Live Ranking API — FAQ

TikTok Live Ranking API ist eine Schnittstelle zum Auslesen der täglichen LIVE-Rangliste der Creator von TikTok, die ohne Eingabe auskommt. Sie liefert bis zu 99 Hosts mit Platz, geschenkebasiertem Wert, Nutzer-ID, Handle, Anzeigename und Follower-Zahl.

score ist der Wert, nach dem TikTok die Hosts heute ordnet, berechnet aus den Geschenken, die ihre Streams erhalten haben. Es ist ein Rangwert und keine Auszahlung in irgendeiner Währung.

Mit diesem Endpunkt nicht. Er nimmt keine Eingabe entgegen und liefert das aktuelle Tagesranking, bewahren Sie also eigene Kopien auf, wenn Sie einen Verlauf brauchen.

Die Plätze verschieben sich, sobald im Laufe des Tages Geschenke eintreffen. Ein Abruf kostet pauschal 0,5 Credits für die ganze Rangliste, ein stündlicher Rhythmus also 12 Credits am Tag.

Nein. Das Ranking ordnet die Hosts, die sie erhalten haben, mit Platz, Wert und Profil jedes Hosts, und enthält keine Liste der Schenkenden.