TikTok Shop Categories
Les catégories TikTok Shop forment la taxonomie des produits d’un marché, chaque catégorie ayant un ID, un nom dans la langue locale, un slug anglais, un niveau de profondeur, un parent et la chaîne des noms qui la surplombent. Disposées en arbre, elles montrent comment un marché regroupe ses produits et fournissent les ID nécessaires pour faire correspondre des catalogues, préparer une étude par catégorie et parcourir une seule branche.
Fonctionnalités de la TikTok Shop Categories API
- Toutes les catégories en un appelUne seule requête renvoie l’arbre entier du marché choisi, des grandes verticales jusqu’aux sous-catégories les plus profondes, chacune sur sa propre ligne.
- Parent, niveau et indicateur de feuilleparent_id relie chaque ligne à la catégorie supérieure, level compte la profondeur à partir de 1 au sommet et is_leaf signale les catégories sans sous-catégorie.
- Les noms des ancêtres dans pathpath liste du haut vers le bas les noms de toutes les catégories situées au-dessus d’une ligne, ce qui permet d’afficher une catégorie profonde dans son contexte sans parcourir l’arbre.
- Des ID qui ouvrent les produits d’une catégorieChaque id peut être transmis comme category_id à TikTok Shop Category Products pour lister les produits classés dans cette catégorie.
Paramètres de la TikTok Shop Categories API
| Paramètres | Obligatoire | Description |
|---|---|---|
region | Facultatif | Marché dont renvoyer l’arborescence : US, SG, MY, PH, TH, VN, ID, JP ou MX. US par défaut. |
Comment utiliser la TikTok Shop Categories API
Demandez l’arbre d’un marché et reconstituez-le à partir des lignes renvoyées.
- Envoyez {"region": "US"} en POST à /v1/tiktok-shop/categories, ou omettez region pour obtenir l’arbre américain.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche ait réussi.
- Récupérez toutes les lignes de results.items en suivant results.next_cursor tant que has_more vaut true, puis imbriquez-les selon parent_id.
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"}'Cas d’usage de la TikTok Shop Categories API
- Reconstruire le menu des catégories : Imbriquez les lignes selon parent_id et ordonnez-les par level pour recréer la navigation par catégories du marché, avec name comme libellé et cover_url comme icône.
- Faire correspondre votre propre catalogue : Rapprochez name, slug et path de vos catégories de produits pour passer de votre taxonomie à celle qu’utilise le TikTok Shop sur ce marché.
- Préparer un balayage par catégorie : Filtrez les lignes d’une verticale choisie dont is_leaf vaut true pour établir la liste des ID à envoyer à TikTok Shop Category Products.
Conseils d’expert pour la TikTok Shop Categories API
- Lorsque has_more vaut true, suivez results.next_cursor jusqu’à la dernière page avant de construire l’arbre, car une page manquante laisse des lignes enfants sans leur parent.
- Traitez les lignes dont parent_id est vide et level vaut 1 comme les racines de l’arbre ; leur path est une liste vide.
- Envoyez les ID de catégorie à TikTok Shop Category Products avec la même region que celle de l’arbre lu, car chaque arbre appartient à un seul marché.
API associées
En complément de la TikTok Shop Categories 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 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 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.