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ètres | Obligatoire | Description |
|---|---|---|
category_id | Obligatoire | ID numérique de catégorie issu du champ id de TikTok Shop Categories, comme 601450. |
region | Facultatif | Marché de la catégorie : US, SG, MY, PH, TH, VN, ID, JP ou MX. US par défaut. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"category_id": "601450", "region": "US", "results_limit": 30} en POST à /v1/tiktok-shop/category-products.
- Interrogez GET /v1/tasks/{task_id} ; les produits sont prêts lorsque status vaut succeeded.
- 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.
API associées
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.