TikTok ShopRecherche de produitsE-commerceSuggestions de rechercheGuide API

API de recherche produits TikTok Shop : produits tendance, catégories et suggestions de recherche

Quatre nouveaux endpoints SocQ TikTok Shop renvoient les produits les plus vendus par marché, l’arborescence complète des catégories, les produits d’une catégorie et les complétions de recherche que voient les acheteurs.

SocQMis à jour le 19 novembre 20268 min de lecture

La recherche de produits sur TikTok Shop commence par trois questions : qu’est-ce qui se vend sur un marché, que contient une catégorie, et que tapent les acheteurs quand ils cherchent ? SocQ renvoyait déjà la recherche de produits, les catalogues de boutiques, les fiches produit, les avis et les vitrines de créateurs ; Les 7 meilleures API et scrapers TikTok Shop les compare. Le 2026-11-17, quatre endpoints ont été ajoutés à la page de la plateforme TikTok Shop pour répondre directement à ces trois questions.

Ce guide présente ce que renvoie chaque endpoint, la requête, le prix et la façon de les enchaîner pour balayer une catégorie.

Réponse rapide : envoyez un corps JSON à POST https://api.socq.ai/v1/tiktok-shop/<endpoint>. Enregistrez le task_id renvoyé, interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez data.results.items.

Les nouveaux endpoints TikTok Shop

1 crédit SocQ = $0,005.

EndpointCe qu’il renvoiePrix
API TikTok Shop Hot ProductsLes produits les plus vendus d’un marché, dans l’ordre de TikTok Shop, avec prix, unités vendues, note et boutique0,5 crédit ($0,0025) par produit
API TikTok Shop CategoriesL’arborescence complète des catégories d’un marché, une ligne par catégorie avec ID, niveau et parent0,5 crédit ($0,0025) par appel
API TikTok Shop Category ProductsLes produits d’une catégorie avec prix, unités vendues, note, avis et boutique0,5 crédit ($0,0025) par produit
API TikTok Shop Search SuggestionsJusqu’à 20 complétions de recherche classées pour le début d’une requête0,5 crédit ($0,0025) par appel

Marchés pris en charge

EndpointValeurs de regionPar défaut
Hot ProductsID, JP, MX, MY, PH, SG, TH, VNaucune, obligatoire
Categories, Category Products, Search SuggestionsUS, SG, MY, PH, TH, VN, ID, JP, MXUS

Hot Products ne propose pas US. Pour la recherche de produits aux États-Unis, utilisez Categories et Category Products.

Authentification et flux de tâches asynchrones

Toutes les requêtes s’authentifient avec une clé API. Le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

L’appel d’envoi répond immédiatement avec data.task_id et data.status. Interrogez la tâche avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse contient result_count, credits_amount et la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si results.has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. Une tâche en échec porte error_message.

Chaque endpoint accepte aussi un callback_url facultatif. SocQ envoie un POST avec un résumé de la tâche lorsqu’elle se termine ; lisez les enregistrements depuis l’endpoint des tâches. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche au lieu de renvoyer la requête. Un 402 signifie que le compte n’a plus de crédits, et un 429 que la clé a atteint une limite de débit ou de crédits.

Hot Products : ce qui se vend sur un marché

L’API Hot Products renvoie les produits les plus vendus d’un marché dans l’ordre où TikTok Shop les classe. Chaque produit comporte son titre, price (montant, devise et chaîne formatée), sold_count, rating, reviews_count, seller et ses images, ainsi que l’url de la fiche produit. region est obligatoire. results_limit vaut 50 par défaut et accepte de 1 à 200. (docs)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "MY", "results_limit": 50}'

Quand l’utiliser : un relevé hebdomadaire par marché pour repérer les produits qui décollent, comparer les prix ou choisir les produits à sourcer et à promouvoir. Les prix sont renvoyés dans la devise locale, par exemple MYR pour la Malaisie : convertissez-les avant de comparer des marchés.

Categories : l’arborescence complète des catégories

L’API Categories renvoie toutes les catégories d’un marché en un seul appel. Chaque ligne contient l’id de la catégorie, name, le slug anglais, level, parent_id, is_leaf, path (les noms des catégories parentes), cover_url et region. Les catégories de premier niveau ont parent_id: null et level: 1, ce qui permet de reconstruire la hiérarchie sous forme d’arbre ou de la garder comme table de correspondance à plat. (docs)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region": "US"}'

Quand l’utiliser : une fois par marché, puis mettez le résultat en cache. Vous avez besoin des ID pour Category Products, et l’arborescence est utile pour faire correspondre les catégories TikTok Shop à votre propre catalogue.

Category Products : parcourir une catégorie comme un acheteur

L’API Category Products prend un category_id numérique issu de l’API Categories et renvoie les produits de cette catégorie avec titre, prix, unités vendues, note, avis, boutique et images. region vaut US par défaut. results_limit vaut 30 par défaut et accepte de 1 à 500. (docs)

curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id": "601450", "region": "US", "results_limit": 30}'

Quand l’utiliser : pour comparer les gammes de prix entre sous-catégories, ou suivre l’évolution des meilleures ventes d’une catégorie dans le temps.

Search Suggestions : ce que tapent les acheteurs

L’API Search Suggestions prend le début d’une recherche d’achat dans query et renvoie jusqu’à 20 complétions, classées à partir de 1, dans l’ordre où TikTok Shop les suggère. Chaque ligne contient le keyword, la query que vous avez envoyée, son rank et la region. region vaut US par défaut. (docs)

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"}'

Quand l’utiliser : recherche de mots-clés pour les fiches, les publicités et les contenus. Pour phone case, la première complétion de l’exemple de la documentation est phone cases 17 pro max, ce qui montre pour quels modèles d’appareils les acheteurs achètent. Injectez les complétions dans TikTok Shop Search pour voir quels produits se classent pour chacune.

Balayer une catégorie en trois appels

Une session de recherche typique pour un marché :

  1. Appelez Categories une fois pour le marché et stockez l’arborescence (0,5 crédit).
  2. Choisissez les catégories feuilles qui vous intéressent (is_leaf: true) et appelez Category Products pour chacune.
  3. Appelez Search Suggestions avec les mots produits clés de chaque catégorie pour voir comment les acheteurs formulent leurs recherches.

Dix catégories de 30 produits chacune font 300 produits, soit 150 crédits. Ajoutez l’arborescence (0,5) et dix appels de suggestions (5), et la session coûte 155,5 crédits, environ $0,78. Sur un marché pris en charge par Hot Products, un relevé de 50 produits ajoute 25 crédits ($0,125).

Lire les champs avec attention

Les lignes produit utilisent le même format normalisé sur les trois endpoints produits. Comme pour les autres champs SocQ, une valeur que la source ne fournit pas vaut null, et non 0. Dans les exemples de la documentation, rating, reviews_count et sold_count valent null pour les produits affichés : traitez donc des ventes ou des notes manquantes comme inconnues, et non comme nulles, avant de classer des produits selon ces valeurs.

Pour approfondir un produit précis, passez son url à l’API TikTok Shop Product, qui ne couvre actuellement que la région US, et à l’API Product Reviews. Pour d’autres façons d’obtenir des données TikTok Shop, consultez Les meilleures alternatives à l’API TikTok Shop. Les produits vendus pendant les LIVE sont couverts par l’API TikTok Live Shopping, présentée dans le guide des nouveaux endpoints TikTok.

FAQ

Faut-il un compte vendeur ou partenaire TikTok Shop ?

Non. Les endpoints lisent des données publiques de TikTok Shop, et vous vous authentifiez avec une clé API SocQ.

Pourquoi Hot Products refuse-t-il US ?

US ne fait pas partie de ses valeurs de region. Hot Products couvre ID, JP, MX, MY, PH, SG, TH et VN. Les trois autres endpoints prennent en charge US et l’utilisent par défaut.

D’où viennent les ID de catégorie ?

De l’API Categories. L’id de chaque ligne est le category_id qu’attend Category Products, pour la même region.

Comment chaque endpoint est-il facturé ?

Categories et Search Suggestions coûtent 0,5 crédit par appel, quel que soit le nombre de lignes renvoyées. Hot Products et Category Products coûtent 0,5 crédit par produit renvoyé.

Combien de suggestions une requête renvoie-t-elle ?

Jusqu’à 20, classées à partir de 1 dans l’ordre de TikTok Shop.

TIKTOK SHOP API

Tester le workflow avec une URL publique TikTok Shop

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API TikTok Shop