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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
room_id | Erforderlich | Numerische ID des LIVE-Raums, entnommen aus der id eines Ergebnisses von TikTok Live Search. |
user_id | Erforderlich | Numerische TikTok-Nutzer-ID des Hosts, entnommen aus author.id desselben Live-Search-Ergebnisses. |
results_limit | Optional | Wie 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.
- Führen Sie TikTok Live Search mit einem Shopping-Stichwort aus und übernehmen Sie id und author.id eines Ergebnisses.
- Senden Sie {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} per POST an /v1/tiktok/live-products.
- 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.
Verwandte APIs
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.
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API