tiktok/
live-products

Die Produkte in der Shopping Bag eines TikTok-LIVE-Streams anhand von Raum-ID und Host-ID auflisten: Titel, aktueller Preis, verkaufte Einheiten, Verkäufer-ID, Produktlink und Bild.

TikTok Live Shopping API

Raum- und Host-ID
Produkte der Shopping Bag
Bis zu 500 Produkte
0,1 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 Shopping

Die Shopping Bag eines TikTok-LIVE-Streams ist die Menge der Produkte, die ein Host während der Übertragung verkauft; jedes Produkt hat Titel, Preis in einer genannten Währung, Zahl der verkauften Einheiten, Verkäufer und Bild. Wer eine Bag ausliest, sieht, was ein Stream gerade pusht, wie diese Artikel während der Übertragung bepreist sind und welche davon sich schon in großer Stückzahl verkaufen.

Funktionen der TikTok Live Shopping API

  • Jedes Produkt der Bagroom_id zusammen mit der user_id des Hosts liefert jedes Produkt der Shopping Bag des Raums als eigenen Datensatz, bis zu den 500, die results_limit erlaubt.
  • Preis als Betrag, Währung und Anzeigetextprice.amount, price.currency und price.formatted liefern die Zahl, den Währungscode und den Text, den Zuschauer sehen, zum Beispiel 41.6, USD und $41.60.
  • Verkaufte Einheiten als Ganzzahlsold_count ist eine ganze Zahl wie 101600, sodass sich Bags direkt sortieren und vergleichen lassen.
  • Produktlink, Verkäufer-ID und BildJeder Datensatz enthält die Produktseite in url, die ID des Verkäufers in seller.id und das Produktbild mit Breite und Höhe in media.

Parameter der TikTok Live Shopping API

ParameterErforderlichBeschreibung
room_idErforderlichNumerische ID des LIVE-Raums, entnommen aus der id eines Ergebnisses von TikTok Live Search.
user_idErforderlichNumerische TikTok-Nutzer-ID des Hosts, entnommen aus author.id desselben Live-Search-Ergebnisses.
results_limitOptionalWie viele Produkte zurückgegeben werden, von 1 bis 500. Standard ist 100.

So verwenden Sie die TikTok Live Shopping API

Finden Sie einen Live-Shopping-Stream und listen Sie seine Bag auf, solange er sendet.

  1. Führen Sie TikTok Live Search mit einem Shopping-Stichwort aus und übernehmen Sie id und author.id eines Ergebnisses.
  2. Senden Sie {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} per POST an /v1/tiktok/live-products.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, lesen Sie dann die Produkte 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-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# Each item is one product with title, price and sold_count.

Anwendungsfälle der TikTok Live Shopping API

  • Die Live-Bag der Konkurrenz lesen: Übernehmen Sie room_id und user_id eines Konkurrenz-Hosts aus Live Search und listen Sie die ganze Bag auf, um zu sehen, welche Produkte und Preislagen er fährt.
  • Preisänderungen während der Übertragung beobachten: Lesen Sie denselben Raum alle paar Minuten aus und vergleichen Sie price.amount je Produkt-id, um die Preissenkungen zu erkennen, die ein Host im Stream ankündigt.
  • Die Bestseller einer Bag finden: Sortieren Sie eine Bag nach sold_count, um zu sehen, welche Artikel schon die meisten Einheiten bewegt haben, und stellen Sie sie ihrem Preis gegenüber.

Profi-Tipps zur TikTok Live Shopping API

  • Prüfen Sie price.currency, bevor Sie Preise zwischen Räumen vergleichen, denn der Betrag hat nur mit seiner Währung eine Aussage.
  • Ordnen Sie dasselbe Produkt zwischen zwei Abrufen über seine id zu; price.amount und sold_count sind die Felder, die sich ändern.

Ergänzend zur TikTok Live Shopping 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 Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • 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 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 Shopping API — FAQ

TikTok Live Shopping API ist eine Schnittstelle zum Auflisten der Produkte in der Shopping Bag eines TikTok-LIVE-Streams, anhand der room_id des Streams und der user_id des Hosts. Sie liefert zu jedem Produkt Titel, Preis, verkaufte Einheiten, Verkäufer-ID, Link und Bild.

Führen Sie TikTok Live Search aus und übernehmen Sie die id eines Ergebnisses als room_id und dessen author.id als user_id. Das Paar muss aus demselben Ergebnis stammen.

results_limit akzeptiert 1 bis 500 und steht standardmäßig auf 100; ist die Bag kleiner, endet die Liste früher. Jedes zurückgegebene Produkt wird mit 0,1 Credits berechnet, eine volle Bag mit 500 Produkten kostet also 50 Credits.

Der Host hat in diesem Raum keine Shopping Bag, oder der Raum sendet nicht mehr. Ein leeres Ergebnis wird nicht berechnet.

Nein, der Raum muss bei der Anfrage live sein. Lesen Sie die Bag, solange der Stream läuft, und speichern Sie sie, wenn Sie das Sortiment später brauchen.

sold_count ist die Zahl der verkauften Einheiten, die TikTok für das Produkt meldet, und null, wenn keine gemeldet wird. Um zu sehen, was während einer Übertragung läuft, lesen Sie die Bag zweimal aus und bilden die Differenz.