TikTok Shop Search
Die Ergebnisse von TikTok Shop Search sind öffentliche Produkte, die in einem gewählten Markt zu einem Keyword passen – mit Produkt- und Verkäuferidentität, Preisen, Bildern, Sternebewertungen, Anzahl der Bewertungen und Verkaufszahlen. Diese Handelsdatensätze eignen sich für die regionale Produktentdeckung, den Preisvergleich, die Verkäuferrecherche und wiederholbare Momentaufnahmen des Marktes.
Funktionen der TikTok Shop Search API
- Steuerung nach Keyword und MarktKombinieren Sie eine Produktabfrage mit einem von 16 unterstützten Werten für region, um den gewünschten öffentlichen Marktkatalog zu durchsuchen.
- Begrenzte eindeutige ErfassungFordern Sie 20 bis 2.000 Ergebnisse an, während die Erfassungsseiten anhand der öffentlichen Produktidentität dedupliziert werden.
- Produkt- und VerkäuferidentitätLiefert Produkt-IDs, Titel, Beschreibungen, kanonische Links und die verfügbaren Angaben zu Verkäufer oder Shop.
- Preise und sichtbare HandelssignaleBehält Verkaufspreis, Originalpreis, Währung, Rabatt, Sternebewertung, Anzahl der Bewertungen und Verkaufszahl bei, sofern sie verfügbar sind.
- Medien und ProduktkontextHält öffentliche Bilder, Kategorien, SKU-Strukturen, Status, Suchanfrage, Region und Erfassungszeitpunkt zu jedem Datensatz fest.
Parameter der TikTok Shop Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Produkt-Keyword oder eine Wortgruppe. |
results_limit | Optional | Angeforderte Obergrenze eindeutiger Ergebnisse von 20 bis 2.000. Standardwert ist 100. |
region | Optional | Marktregion: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP oder IE. Standardwert ist US. |
So verwenden Sie die TikTok Shop Search API
Wählen Sie einen konkreten Produktbegriff und einen Markt und senden Sie dann eine asynchrone Suchanfrage.
- Setzen Sie eine nicht leere query, wählen Sie eine unterstützte region und legen Sie results_limit zwischen 20 und 2.000 fest.
- Senden Sie die Anfrage per POST an /v1/tiktok-shop/search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
- Lesen Sie data.results.items. Ist has_more gleich true, machen Sie mit next_cursor weiter.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der TikTok Shop Search API
- Regionale Produktentdeckung: Erfassen Sie öffentliche Produkte, die in einem gewählten Markt zu einer Kategorie, einem Bedarf, einer Marke oder einem Produktbegriff passen.
- Preis- und Rabattvergleich: Vergleichen Sie die verfügbaren Felder zu Verkaufspreis, Originalpreis, Währung und Rabatt über die zurückgegebenen Produkte hinweg.
- Vergleich von Reputation und Nachfrage: Vergleichen Sie die verfügbaren Sternebewertungen, Anzahlen der Bewertungen und Verkaufszahlen, ohne fehlende Kennzahlen in 0 umzuwandeln.
- Shortlist für Produkte und Shops: Wählen Sie mit Produktlinks, Verkäuferidentität, Bildern, Kategorien und SKU-Kontext Kandidaten für eine genauere Prüfung aus.
Profi-Tipps zur TikTok Shop Search API
- Speichern Sie query und region immer zusammen, denn derselbe Begriff kann zu unterschiedlichen öffentlichen Katalogen führen.
- Setzen Sie results_limit auf das benötigte Volumen und folgen Sie next_cursor, bis has_more den Wert false hat, um das vollständige Aufgabenergebnis zu lesen.
- Behandeln Sie einen fehlenden Preis, eine fehlende Sternebewertung, Anzahl der Bewertungen oder Verkaufszahl als nicht verfügbar und nicht als 0.
- Behalten Sie search_query und collected_at bei jedem Datensatz, damit regionale Momentaufnahmen reproduzierbar bleiben.
- Übergeben Sie eine ausgewählte PDP-URL an die TikTok Shop Product API, wenn Sie eine aktuelle Anreicherung auf Detailebene benötigen.
Verwandte APIs
Ergänzend zur TikTok Shop Search 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 Search Suggestions API — Bis zu 20 gerankte Suchvervollständigungen abrufen, die TikTok Shop in einem Markt für den Anfang einer Shopping-Suche vorschlägt.