tiktok-shop/
category-products

Listez les produits d’une catégorie TikTok Shop à partir de son ID de catégorie et de son marché, avec le titre, le prix et la devise, les unités vendues, la note, les avis et la boutique, jusqu’à 500 par appel.

TikTok Shop Category Products API

ID de catégorie en entrée
9 marchés
Jusqu’à 500 produits
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 Category Products

Les produits d’une catégorie TikTok Shop sont les fiches classées sous une catégorie d’un marché, chacune avec son titre, sa description, son prix et sa devise, ses unités vendues, sa note, son nombre d’avis, sa boutique et ses images. Relevés catégorie par catégorie, ils révèlent les tranches de prix, les meilleures ventes et les boutiques actives d’une verticale, ainsi que leurs différences d’une sous-catégorie à l’autre.

Fonctionnalités de la TikTok Shop Category Products API

  • Parcourir par ID de catégorie plutôt que par mot-clécategory_id reçoit l’ID numérique renvoyé par TikTok Shop Categories : les produits d’une catégorie se lisent directement, sans deviner de termes de recherche.
  • Neuf marchés, US par défautregion couvre US, SG, MY, PH, TH, VN, ID, JP et MX et revient à US lorsqu’il est omis.
  • Jusqu’à 500 produits par catégorieresults_limit va de 1 à 500 avec 30 par défaut : une requête peut prélever un échantillon rapide ou une tranche profonde d’une catégorie.
  • Des champs commerciaux sur chaque produitChaque ligne contient title, text, price avec montant et devise, sold_count, rating, reviews_count, seller et les images de media, ainsi que url pour la fiche produit.

Paramètres de la TikTok Shop Category Products API

ParamètresObligatoireDescription
category_idObligatoireID numérique de catégorie issu du champ id de TikTok Shop Categories, comme 601450.
regionFacultatifMarché de la catégorie : US, SG, MY, PH, TH, VN, ID, JP ou MX. US par défaut.
results_limitFacultatifNombre de produits à renvoyer, de 1 à 500. 30 par défaut.

Comment utiliser la TikTok Shop Category Products API

Prenez un ID de catégorie dans TikTok Shop Categories et lisez les produits qu’il contient.

  1. Envoyez {"category_id": "601450", "region": "US", "results_limit": 30} en POST à /v1/tiktok-shop/category-products.
  2. Interrogez GET /v1/tasks/{task_id} ; les produits sont prêts lorsque status vaut succeeded.
  3. Lisez les produits dans results.items et, si has_more vaut true, demandez la page suivante avec results.next_cursor.
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}'

Cas d’usage de la TikTok Shop Category Products API

  • Comparer les tranches de prix des sous-catégories : Lancez une requête par catégorie enfant et comparez la dispersion de price.amount pour voir à quel niveau se situent les prix de chaque sous-catégorie.
  • Suivre les meilleures ventes d’une catégorie : Relancez une catégorie à intervalles réguliers et suivez sold_count pour chaque id de produit afin de repérer les fiches qui continuent de gagner des ventes.
  • Cartographier les boutiques d’une verticale : Regroupez les produits par seller.id et seller.name pour trouver les boutiques qui ont le plus de fiches et les ventes les plus élevées dans une catégorie.

Conseils d’expert pour la TikTok Shop Category Products API

  • Utilisez la même region que celle d’où provient l’ID de catégorie dans TikTok Shop Categories, puisque chaque marché a sa propre arborescence.
  • Conservez le category_id envoyé à côté de chaque produit retenu, car la catégorie provient de votre requête et non d’un champ de la ligne produit.
  • Indexez les produits sur id lorsque vous fusionnez plusieurs catégories ou des exécutions répétées, pour qu’un produit collecté deux fois ne soit compté qu’une fois.

En complément de la TikTok Shop Category 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 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 Category Products API — FAQ

TikTok Shop Category Products API est une interface programmatique qui liste les produits d’une catégorie TikTok Shop, identifiée par son ID de catégorie et son marché. Elle renvoie pour chaque produit le titre, la description, le prix et la devise, les unités vendues, la note, le nombre d’avis, la boutique, les images et l’URL de la fiche.

Lancez TikTok Shop Categories et copiez l’id de la catégorie voulue. Les ID ne contiennent que des chiffres, comme 601450.

Tout ID de catégorie de l’arbre est accepté. La requête d’exemple de la section Comment l’utiliser envoie 601450, la catégorie de premier niveau Beauty & Personal Care, et un ID plus profond concentre la liste sur une seule branche.

Chaque produit coûte 0,5 crédit : les 30 produits par défaut coûtent 15 crédits et 500 produits en coûtent 250.