tiktok/
search-live

TikTok LIVE per Stichwort durchsuchen und die Streams erhalten, die gerade laufen: Raum-ID, Host-ID, Titel, aktuelle Zuschauer, Likes und Startzeit, bereit für Live-Shopping-Abfragen.

TikTok Live Search API

Stichwortsuche
Nur laufende Streams
Raum- und Host-ID
0,6 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

TikTok Live Search

Ein TikTok-LIVE-Raum ist eine laufende Übertragung, erkennbar an einer Raum-ID, mit Titel, Host, laufender Zuschauerzahl, gesammelten Likes und Startzeit. Gleicht man diese Räume mit einem Stichwort ab, sieht man, wer gerade zu einem Thema sendet und wie groß das Publikum jeweils ist – der Ausgangspunkt für Live-Shopping-Recherche, Host-Suche und die Beobachtung der Live-Aktivität rund um eine Marke.

Funktionen der TikTok Live Search API

  • Stichwort rein, laufende Streams rausquery nimmt ein Stichwort entgegen und liefert die Streams, die in diesem Moment senden, jeweils mit status live.
  • Raum-ID und Host-ID in einem Datensatzid ist die Raum-ID und author.id die Nutzer-ID des Hosts – die beiden Werte, die TikTok Live Shopping braucht, um die Produkte dieses Streams aufzulisten.
  • Publikum zum Zeitpunkt der Erfassungmetrics.viewers_count gibt an, wie viele Personen im Raum sind, und metrics.likes_count, wie viele Likes er gesammelt hat, versehen mit collected_at.
  • Titel, Startzeit, Cover und LIVE-SeiteJeder Datensatz enthält den Stream-Titel, die Startzeit in published_at, das Titelbild in media und einen Link zur LIVE-Seite des Hosts in url, dazu Handle, Anzeigename und Avatar des Hosts.

Parameter der TikTok Live Search API

ParameterErforderlichBeschreibung
queryErforderlichDas Stichwort, zu dem LIVE-Streams gesucht werden.
results_limitOptionalWie viele Streams zurückgegeben werden, von 1 bis 200. Standard ist 20.

So verwenden Sie die TikTok Live Search API

Suchen Sie ein Stichwort und lesen Sie die Streams aus, die gerade live sind.

  1. Senden Sie {"query": "deals", "results_limit": 20} per POST an /v1/tiktok/search-live.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Streams 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/search-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"deals","results_limit":20}'

# id is the room ID; author.id is the host ID for TikTok Live Shopping.

Anwendungsfälle der TikTok Live Search API

  • Live-Verkauf der Konkurrenz auskundschaften: Suchen Sie die Produktwörter, die Verkäufer im Stream sagen, etwa deals, und geben Sie id und author.id jedes Raums an TikTok Live Shopping weiter, um zu lesen, was im Warenkorb liegt.
  • Live-Aktivität rund um ein Stichwort zählen: Führen Sie dieselbe Suche regelmäßig aus und protokollieren Sie, wie viele Streams senden und wie hoch ihr viewers_count ist, um zu sehen, wann ein Thema oder eine Marke Live-Publikum anzieht.
  • Hosts für Kooperationen vorauswählen: Erfassen Sie die Hosts, die zu Ihrem Thema live sind, und ordnen Sie sie nach viewers_count und likes_count, bevor Sie Kontakt aufnehmen.

Profi-Tipps zur TikTok Live Search API

  • Suchen Sie mehrere Formulierungen derselben Nische und führen Sie die Listen über id zusammen, denn jedes Stichwort liefert eigene Streams und ein Stream kann zu mehreren passen.
  • Speichern Sie id und author.id getrennt: id kennzeichnet eine einzelne Übertragung und author.id den Host, einen Host verfolgen Sie über mehrere Tage also anhand von author.id.
  • Um die Zuschauer eines einzelnen Raums im Zeitverlauf zu verfolgen, wechseln Sie von wiederholten Suchen zu TikTok Live Room Info mit dieser room_id und user_id.

Ergänzend zur TikTok Live Search 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 Hashtags API — Öffentliche Videos, Creators, Medien, Sounds und Interaktionen zu angegebenen Hashtags erfassen.
  • TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
  • TikTok Live Room Info API — Einen bekannten Livestream anhand des Paars aus Raum-ID und Besitzer-ID nachschlagen und Status, Besitzerkontext, Cover-Medien und Zuschauerzahlen zurückgeben.
  • TikTok Search Users API — Öffentliche TikTok-Konten per Keyword suchen.
  • TikTok Live Shopping API — Die Produkte im Warenkorb eines LIVE-Streams auflisten – mit aktuellen Preisen und verkauften Einheiten.

Weitere Plattformen entdecken

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

TikTok Live Search API — FAQ

TikTok Live Search API ist eine Schnittstelle zum Finden der TikTok-LIVE-Streams, die gerade laufen und zu einem Stichwort passen, wobei results_limit festlegt, wie viele zurückkommen. Jeder Datensatz enthält Raum-ID, Host-ID, Titel, aktuelle Zuschauer, Likes, Titelbild und Startzeit.

Senden Sie die id eines Ergebnisses als room_id und dessen author.id als user_id an TikTok Live Shopping. Beide Werte müssen aus demselben Ergebnis stammen.

results_limit akzeptiert 1 bis 200 und steht standardmäßig auf 20; die Liste endet früher, wenn weniger Streams passen. Jeder zurückgegebene Stream wird mit 0,6 Credits berechnet, eine Suche ohne Treffer nicht.

Nein. Aufgelistet werden die Streams, die zum Zeitpunkt des Absendens der Suche senden, und jeder Datensatz hat status live. Vergangene Übertragungen werden nicht zurückgegeben.

Streams starten und enden den ganzen Tag über, die Menge der laufenden Übertragungen ändert sich also von Lauf zu Lauf. Verwenden Sie id als Stream-Schlüssel und collected_at als Zeitpunkt jedes Abrufs.

Die Anfrage nimmt nur query und results_limit entgegen. Lesen Sie metrics.viewers_count im Ergebnis und filtern Sie auf Ihrer Seite.

Dieser Endpunkt sucht per Stichwort. Für einen bekannten Account nutzen Sie TikTok User Live, das Benutzernamen entgegennimmt und für jeden den Live-Status meldet.