tiktok-shop/
product-reviews

Öffentliche TikTok-Shop-Bewertungen aus einer Produkt-PDP-URL erfassen – mit Bewertungstext, Sternebewertungen, Angaben zu den Bewertenden, Bildern, SKU und Kaufkontext als normalisierte Datensätze.

TikTok Shop Product Reviews API

Einzelne Produkt-PDP-URL
Öffentlicher Bewertungstext und Sternebewertungen
SKU- und Kaufkontext
Erfassung nach Region
0,3 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 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

ParameterErforderlichBeschreibung
urlErforderlichErforderliche öffentliche TikTok-Shop-URL im Format /shop/pdp/{numeric_id} oder /shop/pdp/{slug}/{numeric_id}; eine Aufgabe akzeptiert ein Produkt.
results_limitOptionalMaximale Anzahl eindeutiger Bewertungen, die über alle Quellseiten hinweg gespeichert werden; Standardwert 100, zulässig sind ganze Zahlen von 20 bis 2.000.
regionOptionalMarktregion 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.

  1. Bereiten Sie eine unterstützte TikTok-Shop-PDP-url, ein results_limit von 20 bis 2.000 und die Marktregion des Produkts vor.
  2. Senden Sie die Anfrage per POST an /v1/tiktok-shop/product-reviews und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie TikTok Shop-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Shop Product Reviews API — FAQ

TikTok Shop Product Reviews API ruft öffentliche Kundenbewertungen zu einer unterstützten TikTok-Shop-PDP-URL ab. Zurückgegeben werden normalisierter Bewertungstext, Sternebewertungen, Angaben zu den Bewertenden, Bilder, Zeitstempel, Produkt- und SKU-Kontext, Länder sowie ausdrückliche Kaufstatus-Merkmale.

Verwenden Sie eine URL auf tiktok.com oder einer TikTok-Subdomain, deren Pfad dem Muster /shop/pdp/{numeric_id} oder /shop/pdp/{slug}/{numeric_id} entspricht. region hat den Standardwert US und akzeptiert US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP und IE.

Die Felder geben nur ausdrückliche Werte wieder, die mit der öffentlichen Bewertung geliefert werden. Fehlt eines der Felder, behandeln Sie den Wert als unbekannt statt als false und schließen Sie weder auf eine Kaufverifizierung noch auf einen Anreizstatus.

results_limit ist eine Obergrenze und keine garantierte Anzahl. Die Erfassung endet beim verfügbaren Bewertungs-Feed, an einer has_more-Grenze der Quelle oder am Limit, und ein entferntes, nicht verfügbares, regional eingeschränktes oder öffentlich nicht zugängliches Produkt kann ohne Datensätze bleiben.

Jede gespeicherte Bewertung kostet 0,3 SocQ-Credits, einschließlich jeder eindeutigen Bewertung, die über Quellseiten hinweg gespeichert wird. Eine Aufgabe ohne gespeicherte Bewertungen wird nicht berechnet.