TikTok Shop User Showcase
Showcases im TikTok Shop sind Produktpräsentationen an öffentlichen TikTok-Profilen – mit Produkt- und Verkäuferidentität, Preisen, Medien, Sternebewertungen, Anzahl der Bewertungen und Verkaufszahlen, sofern verfügbar. Diese Handelssignale eignen sich für die Sortimentsprüfung, regionale Momentaufnahmen, den Produktvergleich und die Anreicherung von Recherche-Datensätzen.
Funktionen der TikTok Shop User Showcase API
- Erfassung des Showcase zu einem BenutzernamenErfasst die öffentlichen Produkte, die zu einem TikTok-Benutzernamen angezeigt werden; der Name wird mit oder ohne führendes @ akzeptiert.
- Auswahl der MarktregionWählen Sie einen von 16 unterstützten Werten für region, damit die Erfassung des Showcase auf den gewünschten öffentlichen TikTok-Shop-Markt zielt.
- Begrenzte eindeutige ProduktergebnisseFordern Sie 20 bis 2.000 Showcase-Produkte an, während die Erfassungsseiten anhand der öffentlichen Produktidentität dedupliziert werden.
- Normalisierter Produkt- und VerkäuferkontextLiefert, sofern verfügbar, Produkt-IDs, Titel, Beschreibungen, kanonische Links, Bilder, Verkäuferfelder, Preise, Kategorien und SKU-Strukturen.
- Sichtbare Handelssignale und öffentliche GrenzenBehält verfügbare Sternebewertungen, Anzahlen der Bewertungen, Verkaufszahlen, Status, Region und Erfassungszeitpunkt bei und lässt nicht verfügbare öffentliche Felder leer.
Parameter der TikTok Shop User Showcase API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
username | Erforderlich | Erforderlicher öffentlicher TikTok-Benutzername. Eine Aufgabe akzeptiert einen Wert, mit oder ohne führendes @. |
results_limit | Optional | Angeforderte Obergrenze eindeutiger Showcase-Produkte von 20 bis 2.000. Standardwert ist 100. |
region | Optional | Marktregion: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP oder IE. Standardwert ist US. |
So verwenden Sie die TikTok Shop User Showcase API
Senden Sie einen öffentlichen Benutzernamen und einen Markt als asynchrone Aufgabe und lesen Sie die gespeicherten Showcase-Produkte dann per Cursor-Paginierung aus.
- Bereiten Sie einen öffentlichen TikTok-Benutzernamen vor, wählen Sie eine unterstützte region und legen Sie results_limit zwischen 20 und 2.000 fest.
- Senden Sie die Anfrage per POST an /v1/tiktok-shop/user-showcase und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
- Lesen Sie data.results.items. Ist has_more gleich true, machen Sie mit next_cursor weiter.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der TikTok Shop User Showcase API
- Showcase-Sortiment eines Kontos prüfen: Untersuchen Sie mit Produkt-IDs, Titeln, Links, Verkäuferkontext, Bildern und Kategorien die öffentlichen Produkte, die zu einem Benutzernamen angezeigt werden.
- Preise und sichtbare Nachfragesignale vergleichen: Vergleichen Sie die verfügbaren Preise, Währungen, Rabatte, Sternebewertungen, Anzahlen der Bewertungen und Verkaufszahlen über die zurückgegebenen Showcase-Produkte hinweg.
- Regionale Showcase-Momentaufnahmen erstellen: Speichern Sie input_username, region, Produktidentität, öffentliche Handelsfelder und collected_at für eine wiederholbare Prüfung zu bestimmten Zeitpunkten.
- Produktrecherche-Datensatz anreichern: Ergänzen Sie einen bestehenden, an Benutzernamen ausgerichteten Recherche-Datensatz um kanonische Produkt-URLs, Verkäuferidentität, Medien, Kategorien, SKU-Kontext und sichtbare Kennzahlen.
Profi-Tipps zur TikTok Shop User Showcase API
- Verwenden Sie über alle Durchläufe hinweg eine einheitliche Schreibweise des Benutzernamens; der Endpunkt akzeptiert @handle oder handle und speichert den normalisierten Eingabe-Benutzernamen bei jedem Produkt.
- Wählen Sie den Markt, der zum gewünschten Katalog passt, denn region hat den Standardwert US und die öffentliche Verfügbarkeit außerhalb der USA kann abweichen.
- Setzen Sie results_limit je nach benötigter Abdeckung zwischen 20 und 2.000, statt davon auszugehen, dass jeder Showcase die standardmäßigen 100 Produkte enthält.
- Folgen Sie nach einem Erfolg next_cursor, solange has_more den Wert true hat, damit die Paginierung des Aufgabenergebnisses keine gespeicherten Produkte ungelesen lässt.
- Deduplizieren Sie Momentaufnahmen nach Produkt-ID und behandeln Sie leere Aufgaben sowie fehlende Felder zu Verkäufer, Preis, Medien, Kategorie, SKU und Kennzahlen als gültige Ergebnisse der öffentlichen Quelle.
Verwandte APIs
Ergänzend zur TikTok Shop User Showcase API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Shop-Daten benötigen.
- TikTok Shop Search API — Öffentliche Produkte von TikTok Shop per Keyword und Marktregion suchen – mit Feldern zu Verkäufer, Preis, Medien, Sternebewertung, Bewertungen und Verkaufszahl.
- TikTok Shop Products API — Öffentliche Produkte aus der Store-URL eines TikTok-Shop-Stores erfassen – mit Feldern zu Verkäufer, Preis, Medien, Kategorie, SKU, Sternebewertung, Bewertungen und Verkaufszahl.
- TikTok Shop Product API — Ein öffentliches TikTok-Shop-Produkt über eine PDP-URL abrufen – mit Feldern zu Verkäufer, Preis, Medien, Kategorie, SKU, Sternebewertung, Bewertungen und Verkaufszahl.
- TikTok Shop Product Reviews API — Öffentliche Bewertungen zu einer TikTok-Shop-PDP-URL erfassen – mit Feldern zu Text, Sternebewertung, Bewertendem, Bild, SKU, Land und Kaufkontext.
- TikTok Shop Hot Products API — Die meistverkauften Produkte eines TikTok-Shop-Markts per Regionscode in Rangfolge erfassen – mit Preis, Währung, verkauften Einheiten, Bewertung und Shop.
- TikTok Shop Categories API — Den vollständigen Kategoriebaum eines TikTok-Shop-Markts abrufen – mit Kategorie-IDs, Namen, englischen Slugs, Ebenen, Elternkategorien und Pfaden.