tiktok-shop/
product

Ein öffentliches TikTok-Shop-Produkt aus einer PDP-URL abrufen – mit Identität, Verkäufer, Preis, sichtbaren Sternebewertungen und Verkaufszahlen, Medien, Kategorien und SKUs in einem normalisierten Datensatz.

TikTok Shop Product API

Öffentliche Produktdetails
Eingabe per PDP-URL
Einzelner normalisierter Datensatz
0,7 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

TikTok-Shop-Produkte sind öffentliche Produktdetailseiten mit Signalen zu Identität, Verkäufer, Preis, Medien, Kategorie, Variante, Sternebewertung, Anzahl der Bewertungen und Verkaufszahl. Diese Felder eignen sich für die Anreicherung von Produkten, die Katalogrecherche, die Prüfung der Warenpräsentation und den Vergleich von Momentaufnahmen.

Funktionen der TikTok Shop Product API

  • Detailabfrage einer einzelnen PDPSenden Sie eine unterstützte öffentliche TikTok-Shop-PDP-URL und erhalten Sie höchstens einen normalisierten Produktdatensatz – der Endpunkt eignet sich also zum Anreichern eines bekannten Artikels und nicht zum Entdecken von Produkten.
  • Verkäufer, Preis und sichtbare HandelssignaleDer Produktdatensatz behält die verfügbare Verkäuferidentität, Verkaufs- und Originalpreis, Währung, Rabatt, Sternebewertung, Anzahl der Bewertungen und Verkaufszahl für die direkte Auswertung auf Feldebene bei.
  • Medien-, Kategorie- und SKU-KontextDie zurückgegebenen Datensätze enthalten die verfügbaren Produktbilder mit Abmessungen sowie Kategorie- und SKU- beziehungsweise Variantenstrukturen der öffentlichen Produktseite.

Parameter der TikTok Shop Product API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche öffentliche TikTok-Shop-URL im Format /shop/pdp/{numeric_id} oder /shop/pdp/{slug}/{numeric_id}; eine Aufgabe akzeptiert ein Produkt.
regionOptionalOptionale Marktregion von TikTok Shop; Standardwert ist US, in anderen akzeptierten Regionen kann die Produktverfügbarkeit abweichen.

So verwenden Sie die TikTok Shop Product API

Senden Sie eine unterstützte Produkt-URL, speichern Sie die Aufgaben-ID der asynchronen Aufgabe und lesen Sie das normalisierte Produkt, sobald die Aufgabe erfolgreich ist.

  1. Senden Sie eine POST-Anfrage an /v1/tiktok-shop/product mit einer unterstützten PDP-url und optional einer region.
  2. Speichern Sie die zurückgegebene task_id und fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  3. Lesen Sie nach einem Erfolg data.results.items und folgen Sie next_cursor nur, wenn has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

Anwendungsfälle der TikTok Shop Product API

  • Anreicherung von Such- oder Katalogergebnissen: Ergänzen Sie mit einer bekannten PDP-URL ein ausgewähltes Produkt aus einer Suche oder einem Shop-Katalog um Felder zu Verkäufer, Preis, Sternebewertung, Medien, Kategorie und SKU.
  • Vergleich von Signal-Momentaufnahmen: Vergleichen Sie erfasste Verkaufspreise, Originalpreise, Rabatte, Sternebewertungen, Anzahlen der Bewertungen und Verkaufszahlen über Produktdatensätze zu verschiedenen Zeitpunkten hinweg.
  • Prüfung von Kategorie und Varianten: Untersuchen Sie die verfügbaren Kategorie-, Bild- und SKU-Strukturen, um nachzuvollziehen, wie ein öffentliches Produkt gegliedert und dargestellt wird.

Profi-Tipps zur TikTok Shop Product API

  • Prüfen Sie vor dem Senden, dass die Eingabe eine vollständige tiktok.com-PDP-URL mit numerischer Produkt-ID ist, damit die Anfrage nicht abgelehnt wird.
  • Lassen Sie region auf US, sofern das Produkt nicht zu einem anderen akzeptierten Markt gehört, und behandeln Sie ein leeres Ergebnis außerhalb der USA als mögliche Verfügbarkeitsgrenze.
  • Senden Sie kein results_limit: Eine Aufgabe akzeptiert eine Produkt-URL und kann höchstens einen normalisierten Datensatz liefern.
  • Behandeln Sie nullbare Felder zu Verkäufer, Preis, Signalen, Medien, Kategorie und SKU als Momentaufnahme der öffentlichen Seite und gehen Sie mit einer erfolgreichen Aufgabe ohne Element um, ohne ein Platzhalterprodukt anzulegen.

Ergänzend zur TikTok Shop Product 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 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.

Weitere Plattformen entdecken

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

TikTok Shop Product API — FAQ

TikTok Shop Product API ruft ein öffentliches Produkt aus einer unterstützten TikTok-Shop-PDP-URL ab. Zurückgegeben werden normalisierte Angaben zu Identität, Verkäufer, Preis, Sternebewertung, Signale zu Bewertungs- und Verkaufszahlen, Medien, Kategorien und SKU-Daten.

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. Andere TikTok-URLs werden als ungültige Eingabe abgelehnt.

Nein. Jede Aufgabe akzeptiert eine Produkt-URL, kennt kein results_limit und gibt höchstens einen normalisierten Produktdatensatz zurück.

region hat den Standardwert US und akzeptiert US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP und IE. Außerhalb der USA kann die Produktverfügbarkeit abweichen.

Eine gültige PDP-URL kann ohne Datensatz bleiben, wenn das Produkt entfernt wurde, in der gewählten Region nicht verfügbar ist oder auf der öffentlichen Seite nicht bereitgestellt wird.

Jeder zurückgegebene Produktdatensatz kostet 0,7 SocQ-Credits. Eine Aufgabe, die kein Produkt liefert, wird nicht berechnet.