TikTok Shop Categories
TikTok Shop Categories bilden die Produkttaxonomie eines Markts, in der jede Kategorie eine ID, einen Namen in Landessprache, einen englischen Slug, eine Tiefenebene, eine Elternkategorie und die Kette der darüberliegenden Namen hat. Als Baum dargestellt, zeigen sie, wie ein Markt seine Produkte gruppiert, und liefern die IDs, die man braucht, um Kataloge zuzuordnen, Kategorierecherchen zu planen und einen einzelnen Zweig zu durchsuchen.
Funktionen der TikTok Shop Categories API
- Jede Kategorie in einem AufrufEine einzige Anfrage liefert den gesamten Baum des gewählten Markts, von den obersten Branchen bis zu den tiefsten Unterkategorien, jede als eigene Zeile.
- Elternkategorie, Ebene und Blattkennzeichenparent_id verbindet jede Zeile mit der Kategorie darüber, level zählt die Tiefe ab 1 an der Spitze, und is_leaf kennzeichnet Kategorien ohne Unterkategorien.
- Namen der Vorfahren in pathpath listet die Namen aller Kategorien oberhalb einer Zeile von der obersten Ebene abwärts, sodass sich eine tiefe Kategorie im Kontext zeigen lässt, ohne den Baum zu durchlaufen.
- IDs, die die Produkte einer Kategorie öffnenJede id lässt sich als category_id an TikTok Shop Category Products übergeben, um die Produkte dieser Kategorie aufzulisten.
Parameter der TikTok Shop Categories API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
region | Optional | Markt, dessen Kategoriebaum geliefert wird: US, SG, MY, PH, TH, VN, ID, JP oder MX. Standardwert US. |
So verwenden Sie die TikTok Shop Categories API
Fordern Sie den Baum eines Markts an und setzen Sie ihn aus den gelieferten Zeilen zusammen.
- Senden Sie {"region": "US"} per POST an /v1/tiktok-shop/categories oder lassen Sie region weg, um den US-Baum zu erhalten.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist.
- Sammeln Sie jede Zeile aus results.items, folgen Sie results.next_cursor, solange has_more true ist, und verschachteln Sie die Zeilen dann nach parent_id.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US"}'Anwendungsfälle der TikTok Shop Categories API
- Das Kategoriemenü nachbauen: Verschachteln Sie die Zeilen nach parent_id und ordnen Sie sie nach level, um die Kategorienavigation des Markts nachzubilden, mit name als Beschriftung und cover_url als Icon.
- Den eigenen Katalog zuordnen: Gleichen Sie name, slug und path mit Ihren Produktkategorien ab, um zwischen Ihrer Taxonomie und der von TikTok Shop in diesem Markt zu übersetzen.
- Einen Kategoriedurchlauf planen: Filtern Sie unter einer gewählten Branche die Zeilen mit is_leaf auf true, um die Liste der IDs für TikTok Shop Category Products zusammenzustellen.
Profi-Tipps zur TikTok Shop Categories API
- Wenn has_more true ist, folgen Sie results.next_cursor bis zur letzten Seite, bevor Sie den Baum aufbauen, denn eine fehlende Seite lässt Unterkategorien ohne ihre Elternkategorie zurück.
- Behandeln Sie Zeilen mit leerem parent_id und level 1 als Wurzeln des Baums; ihr path ist eine leere Liste.
- Senden Sie Kategorie-IDs mit derselben region an TikTok Shop Category Products, aus der der Baum stammt, denn jeder Baum gehört zu einem Markt.
Verwandte APIs
Ergänzend zur TikTok Shop Categories 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 Category Products API — Die Produkte einer TikTok-Shop-Kategorie per Kategorie-ID und Markt auflisten – mit Preis, verkauften Einheiten, Bewertung, Rezensionen und Shop.