TikTok Shop Products
Les produits TikTok Shop sont des fiches publiques de vitrine, avec identité du produit, contexte du vendeur, images, prix, catégories, données de SKU, notes, nombres d’avis et nombres de ventes. Ces enregistrements servent à photographier le catalogue d’une boutique, à comparer des assortiments, à suivre les prix publics et à enrichir les produits un par un.
Fonctionnalités de la TikTok Shop Products API
- Contrôles de catalogue par boutiqueCollectez les produits d’une URL de boutique publique prise en charge, avec une limite de résultats demandée, un tri par meilleures ventes ou par nouveautés et une région de marché documentée.
- Identité du produit, du vendeur et des médiasRenvoie dans chaque enregistrement les ID de produit, les titres, les descriptions disponibles, les URL canoniques, l’identité du vendeur ou de la boutique et les références d’images publiques dédoublonnées.
- Prix et signaux commerciaux visiblesConserve les prix de vente et d’origine exposés, la devise, les valeurs formatées, les remises, les notes, les nombres d’avis et les nombres de ventes pour comparer les produits.
- Lignes de catalogue structuréesGarde le statut disponible, la catégorie et les structures de SKU avec des lignes de produit normalisées, en excluant les compteurs de boutique qui ne se rattachent pas à un produit précis.
Paramètres de la TikTok Shop Products API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL publique obligatoire d’une boutique TikTok Shop de la forme /shop/store/{slug}/{numeric_shop_id} ; une tâche accepte une seule boutique. |
results_limit | Facultatif | Nombre maximal de produits uniques à enregistrer sur l’ensemble des pages de la source ; vaut 100 par défaut et accepte les entiers de 20 à 2 000. |
sort_by | Facultatif | Tri de la source pour le catalogue de la boutique : top pour l’ordre des meilleures ventes ou new_releases pour l’ordre des nouveautés les plus récentes ; vaut top par défaut. |
region | Facultatif | Région de marché TikTok Shop ; vaut US par défaut, et la disponibilité publique du catalogue peut varier dans les autres régions acceptées. |
Comment utiliser la TikTok Shop Products API
Envoyez l’URL d’une boutique TikTok Shop publique avec des contrôles de collecte facultatifs, suivez la tâche asynchrone, puis lisez les produits normalisés grâce à la pagination par curseur.
- Préparez une URL /shop/store/{slug}/{numeric_shop_id} prise en charge et choisissez les valeurs de results_limit, sort_by et region.
- Envoyez la requête en POST à /v1/tiktok-shop/products et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items et demandez le next_cursor renvoyé tant que has_more reste true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la TikTok Shop Products API
- Instantanés du catalogue d’une boutique : Servez-vous des ID de produit, titres, URL, vendeurs, prix, images, catégories, structures de SKU et de collected_at pour constituer le catalogue public d’une boutique à un instant donné.
- Comparaison des assortiments top et nouveautés : Collectez la même boutique avec les tris top et new_releases, puis comparez l’identité, les prix, les catégories et les signaux visibles des produits renvoyés.
- Suivi des prix et signaux publics : Comparez les champs de prix, de remise, de note, de nombre d’avis, de nombre de ventes, de statut et d’heure de collecte, collectés séparément, pour des ID de produit identiques.
- Préparation d’une présélection d’URL de produits : Appuyez-vous sur les URL canoniques, titres, images, contexte du vendeur et indicateurs visibles pour choisir, parmi les produits renvoyés, ceux à traiter dans des workflows de détail ou d’avis.
Conseils d’expert pour la TikTok Shop Products API
- Vérifiez que l’entrée utilise un chemin /shop/store/ public de tiktok.com avec un ID de boutique numérique avant d’envoyer la tâche.
- Réglez region sur le marché de la boutique que vous voulez inspecter ; si une boutique valide ne renvoie aucun enregistrement, vérifiez la disponibilité régionale avant de réessayer.
- Utilisez top pour l’ordre des meilleures ventes de la source ou new_releases pour l’ordre des nouveautés, sans y voir une garantie de rentabilité ou de tendance.
- Considérez results_limit comme le maximum de la collecte et poursuivez le curseur distinct des résultats de la tâche jusqu’à ce que has_more vaille false afin de lire toutes les lignes enregistrées.
- Indexez les instantanés répétés par ID de produit, conservez collected_at et traitez les champs de vendeur, de prix, de statut, de catégorie, de SKU, de médias et de métriques comme facultatifs.
API associées
En complément de la TikTok Shop Products 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 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.