tiktok-shop/
search

Öffentliche TikTok-Shop-Produkte nach Keyword und Marktregion durchsuchen – mit normalisierten Feldern zu Produkt, Verkäufer, Preis, Medien, Sternebewertung, Bewertungen und Verkaufszahl.

TikTok Shop Search API

Produktentdeckung
Regionale Kataloge
Handelssignale
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Produkt-Keyword oder eine Wortgruppe.
results_limitOptionalAngeforderte Obergrenze eindeutiger Ergebnisse von 20 bis 2.000. Standardwert ist 100.
regionOptionalMarktregion: 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.

  1. Setzen Sie eine nicht leere query, wählen Sie eine unterstützte region und legen Sie results_limit zwischen 20 und 2.000 fest.
  2. Senden Sie die Anfrage per POST an /v1/tiktok-shop/search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe succeeded oder failed erreicht.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie TikTok Shop-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Shop Search API — FAQ

TikTok Shop Search API findet öffentlich zugängliche Produkte zu einem Keyword und einer Marktregion. Zurückgegeben werden, sofern verfügbar, normalisierte Felder zu Produkt, Verkäufer, Preis, Medien, Kategorie, SKU, Sternebewertung, Anzahl der Bewertungen und Verkaufszahl.

Nein. TikTok Shop Search ist ein eigenständiger Handels-Endpunkt für öffentliche Produkte, während TikTok Search öffentliche Social-Media-Videos und Creator-Inhalte entdeckt.

query ist erforderlich, results_limit ist eine ganze Zahl von 20 bis 2.000 mit dem Standardwert 100, und region hat den Standardwert US.

Unterstützte Werte sind US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP und IE. Außerhalb der USA kann die Produktverfügbarkeit je nach öffentlichem Marktkatalog abweichen.

Die Ergebnisse können Produkt- und Verkäuferidentität, kanonische URL, Beschreibung, Bilder, Preisangaben, Kategorien, SKUs, Status, Sternebewertung, Anzahl der Bewertungen, Verkaufszahl, Region, Suchanfrage und Erfassungszeitpunkt enthalten.

Der gewählte öffentliche Markt kann weniger passende Produkte enthalten, und die Erfassung endet, wenn nach der Deduplizierung keine weiteren Quellseiten verfügbar sind. Eine erfolgreiche Aufgabe kann deshalb keine oder weniger Elemente als angefordert enthalten.

Fragen Sie /v1/tasks/{task_id} ab, lesen Sie nach dem Erfolg data.results.items und fordern Sie mit next_cursor die nächste Seite des Aufgabenergebnisses an, solange has_more den Wert true hat.

Jedes zurückgegebene normalisierte Produkt kostet 0,7 SocQ-Credits. Leere Ergebnisse werden nicht berechnet.