TikTok Shop Search Suggestions
TikTok Shop Search Suggestions sind die Vervollständigungen, die das Suchfeld des Shops anbietet, während Käufer tippen, jeweils eine vollständige Keyword-Phrase mit ihrer Position in der Liste und dem Markt, in dem sie vorgeschlagen wurde. Weil sie aus tatsächlichen Suchen stammen, zeigen diese Phrasen Produktvarianten, kompatible Modelle und Kaufmotive, die sich in Angebotstiteln, Anzeigen und Inhalten aufgreifen lassen.
Funktionen der TikTok Shop Search Suggestions API
- Vervollständigungen für eine Teilsuchequery nimmt die ersten Wörter einer Suche an, etwa phone case, und jede Zeile liefert eine längere Phrase, zu der Käufer sie ergänzen, etwa phone cases 17 pro max.
- Die Vorschlagsreihenfolge von TikTok Shoprank nummeriert die Vorschläge ab 1 in der Reihenfolge, in der TikTok Shop sie zeigt, mit bis zu 20 pro Suchanfrage.
- Vorschläge pro Marktregion wählt einen der Märkte US, SG, MY, PH, TH, VN, ID, JP und MX, standardmäßig US, und jede Zeile wiederholt ihre query und region, damit Ergebnisse nachvollziehbar bleiben.
Parameter der TikTok Shop Search Suggestions API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Der Anfang einer Shopping-Suche, der vervollständigt werden soll, etwa phone case. |
region | Optional | Suchmarkt: US, SG, MY, PH, TH, VN, ID, JP oder MX. Standardwert US. |
So verwenden Sie die TikTok Shop Search Suggestions API
Senden Sie die ersten Wörter einer Shopping-Suche und lesen Sie die Vervollständigungen in Rangfolge.
- Senden Sie {"query": "phone case", "region": "US"} per POST an /v1/tiktok-shop/search-suggestions.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie keyword und rank aus results.items; wenn has_more true ist, holen Sie den Rest mit results.next_cursor.
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"}'Anwendungsfälle der TikTok Shop Search Suggestions API
- Keywords für Angebotstitel auswählen: Wählen Sie Keyword-Phrasen, die Modelle, Größen oder Varianten nennen, und bauen Sie sie in Produkttitel und Beschreibungen ein.
- Keyword-Sets für Anzeigen und Inhalte aufbauen: Sammeln Sie die Spalte keyword über mehrere Ausgangssuchen hinweg, um Keyword-Listen für Anzeigen, Videobeschreibungen und Content-Planung zusammenzustellen.
- Verfolgen, wie sich Vorschläge verschieben: Führen Sie dieselbe query und region über die Zeit erneut aus und vergleichen Sie rank je keyword, um zu sehen, welche Phrasen steigen, fallen oder neu auftauchen.
- Vergleichen, wie Märkte eine Suche ergänzen: Senden Sie eine Suchanfrage an mehrere Regionen und stellen Sie die keyword-Listen nebeneinander, um zu sehen, wie Käufer in jedem Markt dieselben Wörter ergänzen.
Profi-Tipps zur TikTok Shop Search Suggestions API
- Starten Sie mit einem kurzen Wortstamm statt einer ganzen Phrase, denn Vorschläge verlängern den Anfang der Suche und eine lange Phrase lässt wenig zu ergänzen.
- Gehen Sie eine Ebene tiefer, indem Sie ein geliefertes keyword als neue query zurücksenden; so wird aus einem Ausgangsbegriff ein Baum längerer Phrasen.
- Entfernen Sie Dubletten aus mehreren Ausgangssuchen über keyword, das zugleich die id der Zeile ist, denn verwandte Wortstämme können dieselbe Phrase liefern.
- Übergeben Sie ein vielversprechendes keyword mit derselben region an TikTok Shop Search, um die Produkte hinter diesem Vorschlag zu sehen.
Verwandte APIs
Ergänzend zur TikTok Shop Search Suggestions 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 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 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.