tiktok-shop/
categories

Récupérez l’arborescence complète des catégories de produits d’un marché TikTok Shop à partir d’un code de région facultatif, une ligne par catégorie avec ID, nom, slug anglais, niveau, parent et chemin.

TikTok Shop Categories API

Arborescence complète
Région facultative
Parent et niveau
ID de catégorie
0,5 crédit par requête
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 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ètresObligatoireDescription
regionFacultatifMarché 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.

  1. Envoyez {"region": "US"} en POST à /v1/tiktok-shop/categories, ou omettez region pour obtenir l’arbre américain.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche ait réussi.
  3. 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é.

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.

Explorer d’autres plateformes

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

TikTok Shop Categories API — FAQ

TikTok Shop Categories API est une interface programmatique qui récupère l’arborescence complète des catégories de produits d’un marché TikTok Shop, choisi par un code de région facultatif. Elle renvoie pour chaque catégorie l’ID, le nom, le slug anglais, le parent, le niveau, l’indicateur de feuille, le chemin des ancêtres et l’URL de l’icône.

region accepte US, SG, MY, PH, TH, VN, ID, JP et MX, et vaut US lorsqu’il est omis.

Sélectionnez les lignes dont parent_id est égal à l’id de cette catégorie. Une ligne dont is_leaf vaut true n’a pas de sous-catégorie et termine sa branche.

name suit la langue d’affichage du marché, tandis que slug fournit pour chaque catégorie un libellé d’URL en anglais, utile pour lire des marchés dans d’autres langues.

Chaque appel coûte 0,5 crédit et renvoie toutes les catégories du marché, quel que soit le nombre de lignes de l’arbre.