tiktok-shop/
hot-products

Collectez les produits les plus vendus d’un marché TikTok Shop à partir d’un code de région, avec le titre, le prix et la devise, les unités vendues, la note et la boutique, dans l’ordre de classement du TikTok Shop.

TikTok Shop Hot Products API

Code de marché en entrée
Meilleures ventes classées
Prix en devise locale
Unités vendues
0,5 crédit par résultat
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 Hot Products

TikTok Shop Hot Products désigne le classement des produits les plus vendus sur un marché, où chaque produit porte son titre, son prix en devise locale, ses unités vendues, sa note, son nombre d’avis, sa boutique et ses images. Lus dans l’ordre du classement et comparés d’une semaine à l’autre, ces signaux montrent quels produits décollent, à quels niveaux de prix ils se vendent et quelles boutiques reviennent en tête.

Fonctionnalités de la TikTok Shop Hot Products API

  • Le code de région comme seule entréeChoisissez un marché dans region (ID, JP, MX, MY, PH, SG, TH ou VN) et la liste revient sans mot-clé, catégorie ni lien de boutique à préparer.
  • Le classement dans l’ordre du TikTok ShopLes produits arrivent dans l’ordre où le TikTok Shop les classe, jusqu’à 200 par requête : la position d’une ligne correspond à la place du produit dans la liste.
  • Des prix dans la devise du marchéprice se décompose en un montant numérique, un code de devise comme MYR et le prix formaté, prêts pour le tri et l’analyse par tranches de prix.
  • Signaux de demande et de réputationsold_count, rating et reviews_count figurent sur chaque produit et donnent une lecture rapide des unités écoulées et de l’avis des acheteurs.
  • Boutique et images du produitseller nomme la boutique qui vend chaque produit avec son id, et media liste les images du produit avec leur largeur et leur hauteur.

Paramètres de la TikTok Shop Hot Products API

ParamètresObligatoireDescription
regionObligatoireMarché dont lire le classement : ID, JP, MX, MY, PH, SG, TH ou VN.
results_limitFacultatifNombre de produits classés à renvoyer, de 1 à 200. 50 par défaut.

Comment utiliser la TikTok Shop Hot Products API

Choisissez un marché, décidez jusqu’où lire le classement, puis collectez la liste.

  1. Envoyez {"region": "MY", "results_limit": 50} en POST à /v1/tiktok-shop/hot-products et conservez le task_id renvoyé.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status passe à succeeded.
  3. Lisez les produits classés dans results.items, dans l’ordre ; tant que has_more vaut true, poursuivez avec results.next_cursor.
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}'

Cas d’usage de la TikTok Shop Hot Products API

  • Veille hebdomadaire des meilleures ventes par marché : Enregistrez chaque semaine l’id, la position et le sold_count de chaque produit, puis comparez les exécutions pour voir quels produits entrent dans le classement, y montent ou en sortent.
  • Comparaison des niveaux de prix : Triez price.amount au sein d’une même devise pour repérer la tranche où se concentrent les produits tendance d’un marché avant de fixer le prix de votre propre fiche.
  • Présélection de produits à sourcer : Croisez title, les images de media, sold_count et rating pour retenir les produits à sourcer ou à promouvoir, avec url qui renvoie vers chaque fiche produit.
  • Mesure de la concentration des boutiques : Comptez la fréquence de chaque seller.id en haut du classement pour savoir si quelques boutiques dominent un marché ou si la liste est très dispersée.

Conseils d’expert pour la TikTok Shop Hot Products API

  • Notez vous-même la position de chaque produit en lisant results.items, en continuant le décompte d’une page de curseur à l’autre, car le classement est porté par l’ordre des lignes et non par un champ de rang.
  • Regroupez par price.currency avant de comparer des prix entre marchés, et calculez sur price.amount plutôt que sur le texte formaté.
  • Interprétez un sold_count, un rating ou un reviews_count à null comme une valeur non communiquée et non comme zéro, pour que moyennes et tris gardent leur sens.
  • Gardez region et results_limit identiques d’une exécution à l’autre, afin que les comparaisons hebdomadaires couvrent la même profondeur de classement.

En complément de la TikTok Shop Hot Products API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Shop.

  • 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 User Showcase API — Collectez les produits de la vitrine publique d’un nom d’utilisateur TikTok avec prix, vendeur, médias, note, avis, ventes et contexte régional.
  • 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.
  • TikTok Shop Category Products API — Listez les produits d’une catégorie TikTok Shop par ID de catégorie et marché, avec prix, unités vendues, note, avis et boutique.

Explorer d’autres plateformes

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

TikTok Shop Hot Products API — FAQ

TikTok Shop Hot Products API est une interface programmatique qui récupère le classement des produits les plus vendus d’un marché TikTok Shop, choisi par code de région. Elle renvoie dans l’ordre du classement le titre, la description, la boutique, le prix et la devise, les unités vendues, la note, le nombre d’avis et les images de chaque produit.

region accepte ID, JP, MX, MY, PH, SG, TH et VN, un marché par requête. Pour les produits américains, parcourez une catégorie avec TikTok Shop Category Products ou cherchez par mot-clé avec TikTok Shop Search, qui acceptent tous deux la région US.

Les lignes suivent l’ordre de classement du TikTok Shop : le premier produit de results.items est en tête de liste. Lisez les pages de résultats suivantes dans l’ordre pour conserver le classement complet.

results_limit va de 1 à 200 avec 50 par défaut : une seule requête peut couvrir les 200 premiers produits d’un marché.

Chaque produit renvoyé coûte 0,5 crédit : les 50 produits par défaut reviennent donc à 25 crédits.