TikTok Shop Category Products
TikTok Shop Category Products sind die Angebote, die in einem Markt unter einer Kategorie geführt werden, jeweils mit Titel, Beschreibung, Preis und Währung, verkauften Einheiten, Bewertung, Zahl der Rezensionen, Shop und Bildern. Kategorie für Kategorie abgerufen, zeigen sie die Preisbänder, Bestseller und aktiven Shops einer Branche und wie sich diese von einer Unterkategorie zur nächsten unterscheiden.
Funktionen der TikTok Shop Category Products API
- Nach Kategorie-ID statt Keyword stöberncategory_id nimmt die numerische ID aus TikTok Shop Categories an, sodass die Produkte einer Kategorie direkt gelesen werden, ohne Suchbegriffe raten zu müssen.
- Neun Märkte, standardmäßig USregion deckt US, SG, MY, PH, TH, VN, ID, JP und MX ab und fällt ohne Angabe auf US zurück.
- Bis zu 500 Produkte pro Kategorieresults_limit reicht von 1 bis 500 mit dem Standardwert 30, sodass eine Anfrage eine schnelle Stichprobe oder einen tiefen Ausschnitt einer Kategorie liefern kann.
- Handelsfelder bei jedem ProduktJede Zeile enthält title, text, price mit Betrag und Währung, sold_count, rating, reviews_count, seller und Bilder in media sowie url für die Produktseite.
Parameter der TikTok Shop Category Products API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
category_id | Erforderlich | Numerische Kategorie-ID aus dem Feld id von TikTok Shop Categories, etwa 601450. |
region | Optional | Markt der Kategorie: US, SG, MY, PH, TH, VN, ID, JP oder MX. Standardwert US. |
results_limit | Optional | Zahl der zu liefernden Produkte, von 1 bis 500. Standardwert 30. |
So verwenden Sie die TikTok Shop Category Products API
Nehmen Sie eine Kategorie-ID aus TikTok Shop Categories und lesen Sie die Produkte darunter.
- Senden Sie {"category_id": "601450", "region": "US", "results_limit": 30} per POST an /v1/tiktok-shop/category-products.
- Fragen Sie GET /v1/tasks/{task_id} ab; die Produkte sind fertig, sobald status den Wert succeeded hat.
- Lesen Sie die Produkte aus results.items und rufen Sie, wenn has_more true ist, die nächste Seite mit results.next_cursor ab.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id":"601450","region":"US","results_limit":30}'Anwendungsfälle der TikTok Shop Category Products API
- Preisbänder verschiedener Unterkategorien vergleichen: Stellen Sie eine Anfrage pro Unterkategorie und vergleichen Sie die Streuung von price.amount, um zu sehen, wo die Produkte jeder Unterkategorie preislich liegen.
- Die Bestseller einer Kategorie verfolgen: Fragen Sie eine Kategorie regelmäßig erneut ab und verfolgen Sie sold_count je Produkt-id, um die Angebote zu finden, die laufend Verkäufe hinzugewinnen.
- Die Shops einer Branche erfassen: Gruppieren Sie die Produkte nach seller.id und seller.name, um die Shops mit den meisten Angeboten und den höchsten Verkäufen in einer Kategorie zu finden.
Profi-Tipps zur TikTok Shop Category Products API
- Verwenden Sie dieselbe region, aus der die Kategorie-ID in TikTok Shop Categories stammt, denn jeder Markt hat seinen eigenen Kategoriebaum.
- Speichern Sie die gesendete category_id neben jedem Produkt, das Sie behalten, denn die Kategorie stammt aus Ihrer Anfrage und nicht aus einem Feld der Produktzeile.
- Verwenden Sie id als Schlüssel, wenn Sie mehrere Kategorien oder wiederholte Läufe zusammenführen, damit ein doppelt gesammeltes Produkt nur einmal zählt.
Verwandte APIs
Ergänzend zur TikTok Shop Category Products API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Shop-Daten benötigen.
- 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 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.