TikTok ShopProduktrechercheE-CommerceSuchvorschlägeAPI-Leitfaden

TikTok Shop API für Produktrecherche: Bestseller, Kategorien und Suchvorschläge

Vier neue TikTok-Shop-Endpunkte von SocQ liefern meistverkaufte Produkte nach Markt, den vollständigen Kategoriebaum, die Produkte einer Kategorie und die Suchvervollständigungen, die Käufer sehen.

SocQAktualisiert am 19. November 20267 Min. Lesezeit

Produktrecherche auf TikTok Shop beginnt mit drei Fragen: Was verkauft sich in einem Markt, was steckt in einer Kategorie, und was tippen Käufer bei der Suche ein? SocQ lieferte bereits Produktsuche, Shop-Kataloge, Produktseiten, Bewertungen und Creator-Showcases; Die 7 besten TikTok-Shop-APIs und -Scraper vergleicht diese. Am 2026-11-17 kamen auf der TikTok-Shop-Plattformseite vier Endpunkte hinzu, die diese drei Fragen direkt beantworten.

Dieser Leitfaden zeigt, was jeder Endpunkt zurückgibt, welche Anfrage er erwartet, was er kostet und wie Sie die Endpunkte zu einem Kategorie-Durchlauf verketten.

Kurze Antwort: Senden Sie einen JSON-Body an POST https://api.socq.ai/v1/tiktok-shop/<endpoint>. Speichern Sie die zurückgegebene task_id, fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie dann data.results.items.

Die neuen TikTok-Shop-Endpunkte

1 SocQ-Credit = $0,005.

EndpunktRückgabePreis
TikTok Shop Hot Products APIMeistverkaufte Produkte eines Markts in der Reihenfolge von TikTok Shop, mit Preis, verkauften Einheiten, Bewertung und Shop0,5 Credits ($0,0025) pro Produkt
TikTok Shop Categories APIDer vollständige Kategoriebaum eines Markts, eine Zeile pro Kategorie mit ID, Ebene und übergeordneter Kategorie0,5 Credits ($0,0025) pro Aufruf
TikTok Shop Category Products APIProdukte einer Kategorie mit Preis, verkauften Einheiten, Bewertung, Rezensionen und Shop0,5 Credits ($0,0025) pro Produkt
TikTok Shop Search Suggestions APIBis zu 20 Suchvervollständigungen für den Anfang einer Suchanfrage, nach Rang0,5 Credits ($0,0025) pro Aufruf

Unterstützte Märkte

Endpunktregion-WerteStandard
Hot ProductsID, JP, MX, MY, PH, SG, TH, VNkeiner, Pflichtfeld
Categories, Category Products, Search SuggestionsUS, SG, MY, PH, TH, VN, ID, JP, MXUS

Hot Products führt US nicht. Für Produktrecherche in den USA nutzen Sie Categories und Category Products.

Authentifizierung und der asynchrone Aufgabenablauf

Alle Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header wird für Übermittlung, Aufgabenstatus und Ergebnisabruf verwendet:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jede Erfassung läuft als Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Der Übermittlungsaufruf antwortet sofort mit data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Hat status den Wert succeeded, enthält die Antwort result_count, credits_amount und die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn results.has_more true ist, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Eine fehlgeschlagene Aufgabe enthält error_message.

Jeder Endpunkt akzeptiert außerdem eine optionale callback_url. SocQ sendet nach Abschluss der Aufgabe einen einzelnen POST mit einer Zusammenfassung; die Datensätze lesen Sie über den Aufgaben-Endpunkt. Eine Zeitüberschreitung beim Client bricht eine Aufgabe nicht ab. Setzen Sie daher mit derselben Aufgaben-ID fort, statt erneut zu übermitteln. Ein 402 bedeutet, dass das Konto keine Credits mehr hat, und ein 429, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.

Hot Products: Was sich in einem Markt verkauft

Die Hot Products API liefert die meistverkauften Produkte eines Markts in der Reihenfolge, in der TikTok Shop sie einstuft. Jedes Produkt hat Titel, price (Betrag, Währung und formatierter String), sold_count, rating, reviews_count, seller und Bilder sowie die url der Produktseite. region ist Pflicht. results_limit ist standardmäßig 50 und akzeptiert 1 bis 200. (Doku)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "MY", "results_limit": 50}'

Wann Sie es einsetzen: als wöchentlicher Schnappschuss pro Markt, um Durchstarter-Produkte zu erkennen, Preise zu vergleichen oder Produkte für Beschaffung und Bewerbung auszuwählen. Preise kommen in der lokalen Währung zurück, etwa MYR für Malaysia. Rechnen Sie sie also um, bevor Sie Märkte vergleichen.

Categories: Der vollständige Kategoriebaum

Die Categories API liefert alle Kategorien eines Markts in einem Aufruf. Jede Zeile enthält die Kategorie-id, name, den englischen slug, level, parent_id, is_leaf, path (die übergeordneten Namen), cover_url und region. Kategorien der obersten Ebene haben parent_id: null und level: 1. So können Sie die Hierarchie als Baum nachbauen oder als flache Nachschlagetabelle behalten. (Doku)

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"}'

Wann Sie es einsetzen: einmal pro Markt, danach das Ergebnis zwischenspeichern. Sie brauchen die IDs für Category Products, und der Baum hilft, TikTok-Shop-Kategorien Ihrem eigenen Katalog zuzuordnen.

Category Products: Eine Kategorie wie ein Käufer durchstöbern

Die Category Products API nimmt eine numerische category_id aus der Categories API entgegen und liefert die Produkte dieser Kategorie mit Titel, Preis, verkauften Einheiten, Bewertung, Rezensionen, Shop und Bildern. region ist standardmäßig US. results_limit ist standardmäßig 30 und akzeptiert 1 bis 500. (Doku)

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}'

Wann Sie es einsetzen: um Preisspannen zwischen Unterkategorien zu vergleichen oder zu beobachten, wie sich die Bestseller einer Kategorie im Lauf der Zeit verändern.

Search Suggestions: Was Käufer eintippen

Die Search Suggestions API nimmt in query den Anfang einer Shopping-Suche entgegen und liefert bis zu 20 Vervollständigungen, ab 1 nummeriert, in der Reihenfolge, in der TikTok Shop sie vorschlägt. Jede Zeile enthält das keyword, die gesendete query, ihren rank und die region. region ist standardmäßig US. (Doku)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "phone case", "region": "US"}'

Wann Sie es einsetzen: für Keyword-Recherche zu Listings, Anzeigen und Inhalten. Für phone case ist die oberste Vervollständigung im Doku-Beispiel phone cases 17 pro max. Das zeigt, für welche Gerätemodelle Käufer einkaufen. Geben Sie die Vervollständigungen in TikTok Shop Search ein, um zu sehen, welche Produkte für jede davon ranken.

Ein Kategorie-Durchlauf in drei Aufrufen

Ein typischer Recherchedurchlauf für einen Markt:

  1. Rufen Sie Categories einmal für den Markt auf und speichern Sie den Baum (0,5 Credits).
  2. Wählen Sie die relevanten untersten Kategorien (is_leaf: true) aus und rufen Sie für jede Category Products auf.
  3. Rufen Sie Search Suggestions mit den zentralen Produktbegriffen jeder Kategorie auf, um zu sehen, wie Käufer ihre Suchen formulieren.

Zehn Kategorien mit je 30 Produkten ergeben 300 Produkte oder 150 Credits. Mit dem Baum (0,5) und zehn Vorschlagsaufrufen (5) kostet der Durchlauf 155,5 Credits, etwa $0,78. In einem Markt, den Hot Products unterstützt, kommen für einen Schnappschuss mit 50 Produkten 25 Credits ($0,125) hinzu.

Die Felder genau lesen

Produktzeilen haben bei allen drei Produkt-Endpunkten dieselbe normalisierte Struktur. Wie bei anderen SocQ-Feldern ist ein Wert, den die Quelle nicht liefert, null und nicht 0. In den Doku-Beispielen sind rating, reviews_count und sold_count für die gezeigten Produkte null. Behandeln Sie fehlende Verkaufszahlen oder Bewertungen daher als unbekannt, nicht als null, bevor Sie Produkte danach ranken.

Um ein einzelnes Produkt genauer zu untersuchen, übergeben Sie dessen url an die TikTok Shop Product API, die derzeit nur die Region USA bedient, und an die Product Reviews API. Andere Wege zu TikTok-Shop-Daten zeigt Alternativen zur TikTok Shop API. Produkte, die in LIVE-Streams verkauft werden, deckt die TikTok Live Shopping API im Leitfaden zu den neuen TikTok-Endpunkten ab.

FAQ

Brauche ich ein Verkäufer- oder Partnerkonto bei TikTok Shop?

Nein. Die Endpunkte lesen öffentliche TikTok-Shop-Daten, und Sie authentifizieren sich mit einem SocQ-API-Schlüssel.

Warum lehnt Hot Products US ab?

US gehört nicht zu seinen region-Werten. Hot Products deckt ID, JP, MX, MY, PH, SG, TH und VN ab. Die anderen drei Endpunkte unterstützen US und verwenden es als Standard.

Woher kommen die Kategorie-IDs?

Aus der Categories API. Die id jeder Zeile ist die category_id, die Category Products für dieselbe region erwartet.

Wie wird jeder Endpunkt abgerechnet?

Categories und Search Suggestions kosten 0,5 Credits pro Aufruf, unabhängig von der Zahl der zurückgegebenen Zeilen. Hot Products und Category Products kosten 0,5 Credits pro zurückgegebenem Produkt.

Wie viele Vorschläge liefert eine Suchanfrage?

Bis zu 20, ab 1 nummeriert in der Reihenfolge von TikTok Shop.

TIKTOK SHOP API

Workflow mit einer öffentlichen TikTok Shop-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

TikTok Shop-APIs ansehen