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
| 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. |
region | Optional | Optionale 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.
- Senden Sie eine POST-Anfrage an /v1/tiktok-shop/product mit einer unterstützten PDP-url und optional einer region.
- Speichern Sie die zurückgegebene task_id und fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- 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 succeededAnwendungsfä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.
Verwandte APIs
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.