TikTok Shop Product Reviews
TikTok-Shop-Produktbewertungen sind öffentliche Kundenrückmeldungen mit Text, Sternebewertungen, Namen der Bewertenden, Bildern, Zeitstempeln, SKU-Angaben, Ländern und ausdrücklichen Kaufstatus-Merkmalen. Diese Felder eignen sich für die Analyse von Produktfeedback, den Vergleich nach Varianten und Regionen sowie für belegorientierte Bewertungs-Workflows.
Funktionen der TikTok Shop Product Reviews API
- Ein Produkt mit regionalem BezugSenden Sie eine unterstützte öffentliche PDP-URL mit einer Marktregion und erfassen Sie die eindeutigen Bewertungen, die für dieses Produkt bereitstehen, bis zum angeforderten Limit.
- Bewertungsinhalt, Sternebewertung, Autor und MedienJeder normalisierte Datensatz behält den verfügbaren Bewertungstext, die numerische Sternebewertung, die Identität der bewertenden Person, Bilder, Veröffentlichungszeitpunkt, Produkt-URL und Erfassungszeitpunkt bei.
- Produkt-, SKU-, Länder- und KaufkontextBewertungsdatensätze enthalten Produkt- und SKU-Kennungen, Variantenspezifikationen, das Land der Bewertung sowie, sofern angegeben, ausdrückliche Merkmale für verifizierte Käufe oder Bewertungen gegen Anreiz.
Parameter der TikTok Shop Product Reviews API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche öffentliche TikTok-Shop-URL im Format /shop/pdp/{numeric_id} oder /shop/pdp/{slug}/{numeric_id}; eine Aufgabe akzeptiert ein Produkt. |
results_limit | Optional | Maximale Anzahl eindeutiger Bewertungen, die über alle Quellseiten hinweg gespeichert werden; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000. |
region | Optional | Marktregion von TikTok Shop; Standardwert ist US, in anderen akzeptierten Regionen kann die Verfügbarkeit öffentlicher Produkte oder Bewertungen abweichen. |
So verwenden Sie die TikTok Shop Product Reviews API
Senden Sie eine unterstützte Produkt-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Bewertungsdatensätze per Cursor-Paginierung aus.
- Bereiten Sie eine unterstützte TikTok-Shop-PDP-url, ein results_limit von 20 bis 2.000 und die Marktregion des Produkts vor.
- Senden Sie die Anfrage per POST an /v1/tiktok-shop/product-reviews und speichern Sie die zurückgegebene task_id.
- Fragen Sie GET /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/product-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","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 Product Reviews API
- Analyse von Produktfeedback: Nutzen Sie Bewertungstext, numerische Sternebewertungen, Zeitstempel und Produktidentität, um das öffentliche Feedback zu einem bekannten Produkt zu untersuchen.
- Vergleich von Feedback nach SKU und Region: Gruppieren Sie Datensätze nach SKU-Spezifikation oder Land der Bewertung und vergleichen Sie dann Text und Sternebewertungen, ohne Werte für fehlende Felder abzuleiten.
- Prüfung von Kaufkontext und Bewertungsmedien: Sehen Sie sich von Kunden hochgeladene Bilder an und segmentieren Sie Datensätze nach ausdrücklichen Merkmalen für verifizierte Käufe oder Bewertungen gegen Anreiz, sofern diese Werte vorliegen.
Profi-Tipps zur TikTok Shop Product Reviews API
- Prüfen Sie vor dem Senden, dass die Eingabe eine vollständige tiktok.com-PDP-URL mit numerischer Produkt-ID ist, denn Profil-, Video-, Shop- und andere TikTok-URLs werden abgelehnt.
- Wählen Sie die Region, die zum Produktmarkt passt; eine gültige URL kann trotzdem keine öffentlichen Bewertungen liefern, wenn der gewählte Markt das Produkt oder seinen Bewertungs-Feed nicht bereitstellt.
- Setzen Sie results_limit zwischen 20 und 2.000, um die gewünschte Abdeckung zu erreichen, und folgen Sie next_cursor, bis has_more den Wert false hat, um jede gespeicherte Ergebnisseite zu lesen.
- Behandeln Sie fehlenden Bewertungstext, fehlende Angaben zur bewertenden Person, zur SKU und zum Kaufstatus als unbekannt; ein fehlender boolescher Wert ist nicht false, und ein Datensatz nur mit Sternebewertung bleibt gültig.
Verwandte APIs
Ergänzend zur TikTok Shop Product Reviews 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 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.