tiktok-shop/
search-suggestions

Obtenez les complétions que le TikTok Shop propose pour le début d’une recherche d’achat sur un marché donné, soit jusqu’à 20 expressions classées à partir de 1, avec leur requête et leur région.

TikTok Shop Search Suggestions API

Requête partielle en entrée
Jusqu’à 20 complétions
Classées à partir de 1
0,5 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoireLe début d’une recherche d’achat à compléter, comme phone case.
regionFacultatifMarché 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.

  1. Envoyez {"query": "phone case", "region": "US"} en POST à /v1/tiktok-shop/search-suggestions.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données TikTok Shop avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Shop Search Suggestions API — FAQ

TikTok Shop Search Suggestions API est une interface programmatique qui récupère les complétions de recherche que le TikTok Shop propose pour le début d’une requête d’achat sur un marché. Elle renvoie jusqu’à 20 expressions suggérées, chacune avec son rang, la requête d’origine et la région.

Chaque requête accepte une seule query. Pour couvrir plusieurs mots-clés de départ, envoyez une requête par mot-clé et fusionnez les résultats sur keyword.

Chaque appel coûte 0,5 crédit et renvoie jusqu’à 20 suggestions ; le prix s’entend par appel, non par suggestion.