TikTok Shop Products
TikTok-Shop-Produkte sind Produkteinträge in öffentlichen Shops mit Angaben zu Produktidentität, Verkäuferkontext, Bildern, Preisen, Kategorien, SKU-Daten, Sternebewertungen, Anzahl der Bewertungen und Verkaufszahlen. Diese Datensätze eignen sich für Momentaufnahmen von Shop-Katalogen, den Vergleich von Sortimenten, die Beobachtung öffentlicher Preise und die Anreicherung auf Produktebene.
Funktionen der TikTok Shop Products API
- Steuerung des Shop-KatalogsErfassen Sie Produkte aus einer unterstützten öffentlichen Store-URL mit einem angeforderten Ergebnislimit, der Sortierung nach Top oder Neuheiten und einer dokumentierten Marktregion.
- Produkt-, Verkäufer- und MedienidentitätLiefert pro Datensatz Produkt-IDs, Titel, verfügbare Beschreibungen, kanonische URLs, die Identität von Verkäufer oder Shop sowie deduplizierte Verweise auf öffentliche Bilder.
- Preise und sichtbare HandelssignaleBehält die verfügbaren Verkaufs- und Originalpreise, die Währung, formatierte Werte, Rabatte, Sternebewertungen, Anzahl der Bewertungen und Verkaufszahlen für den Produktvergleich bei.
- Strukturierte KatalogzeilenHält verfügbaren Status sowie Kategorie- und SKU-Strukturen mit den normalisierten Produktzeilen zusammen und schließt Zähler auf Shop-Ebene aus, die keinem einzelnen Produkt zugeordnet sind.
Parameter der TikTok Shop Products API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche öffentliche TikTok-Shop-Store-URL im Format /shop/store/{slug}/{numeric_shop_id}; eine Aufgabe akzeptiert einen Store. |
results_limit | Optional | Maximale Anzahl eindeutiger Produkte, die über alle Quellseiten hinweg gespeichert werden; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000. |
sort_by | Optional | Sortierung des Store-Katalogs durch die Quelle: top für die Bestseller-Reihenfolge oder new_releases für die Reihenfolge nach neuesten Produkten; Standardwert ist top. |
region | Optional | Marktregion von TikTok Shop; Standardwert ist US, in anderen akzeptierten Regionen kann die Verfügbarkeit des öffentlichen Katalogs abweichen. |
So verwenden Sie die TikTok Shop Products API
Senden Sie eine öffentliche TikTok-Shop-Store-URL mit optionalen Erfassungsparametern, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Produktdatensätze per Cursor-Paginierung aus.
- Bereiten Sie eine unterstützte URL im Format /shop/store/{slug}/{numeric_shop_id} vor und wählen Sie Werte für results_limit, sort_by und region.
- Senden Sie die Anfrage per POST an /v1/tiktok-shop/products und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- Lesen Sie data.results.items und fordern Sie die zurückgegebene next_cursor an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","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 Products API
- Momentaufnahmen von Shop-Katalogen: Stellen Sie mit Produkt-IDs, Titeln, URLs, Verkäufern, Preisen, Bildern, Kategorien, SKU-Strukturen und collected_at eine Momentaufnahme eines öffentlichen Store-Katalogs zusammen.
- Sortimentsvergleich nach Top und Neuheiten: Erfassen Sie denselben Store mit der Sortierung top und new_releases und vergleichen Sie dann die zurückgegebene Produktidentität, Preise, Kategorien und sichtbaren Produktsignale.
- Verfolgung öffentlicher Preise und Signale: Vergleichen Sie unabhängig erfasste Felder zu Preis, Rabatt, Sternebewertung, Anzahl der Bewertungen, Verkaufszahl, Status und Erfassungszeitpunkt für übereinstimmende Produkt-IDs.
- Vorbereitung einer Shortlist von Produkt-URLs: Nutzen Sie kanonische Produkt-URLs, Titel, Bilder, Verkäuferkontext und sichtbare Kennzahlen, um zurückgegebene Produkte für Detail- oder Bewertungs-Workflows auszuwählen.
Profi-Tipps zur TikTok Shop Products API
- Prüfen Sie vor dem Senden der Aufgabe, dass die Eingabe einen öffentlichen tiktok.com-Pfad /shop/store/ mit numerischer Shop-ID verwendet.
- Setzen Sie region auf den Store-Markt, den Sie untersuchen möchten; liefert ein gültiger Store keine Datensätze, prüfen Sie die regionale Verfügbarkeit, bevor Sie es erneut versuchen.
- Verwenden Sie top für die Bestseller-Reihenfolge der Quelle oder new_releases für die Reihenfolge nach neuesten Produkten und deuten Sie keinen der beiden Modi als Garantie für Rentabilität oder Trend.
- Behandeln Sie results_limit als Obergrenze der Erfassung und folgen Sie dem separaten Cursor des Aufgabenergebnisses, bis has_more den Wert false hat, um jede gespeicherte Zeile zu lesen.
- Schlüsseln Sie wiederholte Momentaufnahmen nach Produkt-ID, behalten Sie collected_at bei und behandeln Sie Felder zu Verkäufer, Preis, Status, Kategorie, SKU, Medien und Kennzahlen als optional.
Verwandte APIs
Ergänzend zur TikTok Shop Products 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 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 User Showcase API — Öffentliche Showcase-Produkte zu einem TikTok-Benutzernamen erfassen – mit Preis, Verkäufer, Medien, Sternebewertung, Bewertungen, Verkaufszahl und regionalem Kontext.
- 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.