TikTok Shop Search Suggestions
Les suggestions de recherche TikTok Shop sont les complétions que la barre de recherche de la boutique propose pendant la saisie, chacune étant une expression complète avec sa position dans la liste et le marché où elle a été suggérée. Comme elles viennent de ce que les gens recherchent réellement, ces expressions font apparaître des variantes de produits, des modèles compatibles et des angles d’achat à cibler dans les titres de fiches, les publicités et les contenus.
Fonctionnalités de la TikTok Shop Search Suggestions API
- Des complétions pour une recherche partiellequery reçoit les premiers mots d’une recherche, comme phone case, et chaque ligne renvoie une expression plus longue que les acheteurs en tirent, comme phone cases 17 pro max.
- L’ordre de suggestion du TikTok Shoprank numérote les suggestions à partir de 1 dans l’ordre où le TikTok Shop les affiche, jusqu’à 20 par requête.
- Des suggestions par marchéregion sélectionne US, SG, MY, PH, TH, VN, ID, JP ou MX, US par défaut, et chaque ligne reprend sa query et sa region pour que les résultats restent traçables.
Paramètres de la TikTok Shop Search Suggestions API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Le début d’une recherche d’achat à compléter, comme phone case. |
region | Facultatif | Marché de recherche : US, SG, MY, PH, TH, VN, ID, JP ou MX. US par défaut. |
Comment utiliser la TikTok Shop Search Suggestions API
Envoyez les premiers mots d’une recherche d’achat et lisez les complétions dans l’ordre de leur rang.
- Envoyez {"query": "phone case", "region": "US"} en POST à /v1/tiktok-shop/search-suggestions.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez keyword et rank dans results.items ; lorsque has_more vaut true, récupérez la suite avec 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"}'Cas d’usage de la TikTok Shop Search Suggestions API
- Choisir les mots-clés des titres de fiches : Retenez les expressions qui nomment des modèles, des tailles ou des variantes et intégrez-les aux titres et descriptions de vos produits.
- Constituer des listes de mots-clés pour les publicités et les contenus : Rassemblez la colonne keyword de plusieurs requêtes de départ pour bâtir des listes de mots-clés destinées aux publicités, aux légendes de vidéos et au planning éditorial.
- Suivre l’évolution des suggestions : Relancez la même query et la même region dans le temps et comparez le rank de chaque keyword pour voir quelles expressions montent, baissent ou apparaissent.
- Comparer la façon dont les marchés complètent une recherche : Envoyez une même query à plusieurs régions et mettez les listes de keyword côte à côte pour voir comment les acheteurs de chaque marché complètent les mêmes mots.
Conseils d’expert pour la TikTok Shop Search Suggestions API
- Partez d’une racine courte plutôt que d’une expression complète, car les suggestions prolongent le début de la requête et une longue expression laisse peu à compléter.
- Descendez d’un niveau en renvoyant un keyword obtenu comme nouvelle query : une requête de départ devient alors un arbre d’expressions plus longues.
- Dédoublonnez les résultats de plusieurs requêtes de départ sur keyword, qui sert aussi d’id de ligne, car des racines proches peuvent renvoyer la même expression.
- Transmettez un keyword prometteur à TikTok Shop Search avec la même region pour voir les produits derrière cette suggestion.
API associées
En complément de la TikTok Shop Search Suggestions API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Shop.
- TikTok Shop Search API — Recherchez des produits publics du TikTok Shop par mot-clé et région de marché avec vendeur, prix, médias, note, avis et ventes.
- TikTok Shop Products API — Collectez les produits publics d’une boutique TikTok Shop à partir de son URL avec vendeur, prix, médias, catégorie, SKU, note, avis et ventes.
- TikTok Shop Product API — Récupérez un produit public du TikTok Shop à partir de l’URL de sa page produit avec vendeur, prix, médias, catégorie, SKU, note, avis et ventes.
- TikTok Shop Product Reviews API — Collectez les avis publics d’une page produit TikTok Shop à partir de son URL avec texte, note, auteur, image, SKU, pays et contexte d’achat.
- TikTok Shop Hot Products API — Collectez les produits les plus vendus d’un marché TikTok Shop par code de région, dans l’ordre du classement, avec prix, devise, unités vendues, note et boutique.
- TikTok Shop Categories API — Récupérez l’arborescence complète des catégories d’un marché TikTok Shop avec ID, noms, slugs anglais, niveaux, parents et chemins.