tiktok-shop/
products

Collectez les produits publics d’une URL de boutique TikTok Shop, avec identité, prix, images, contexte du vendeur, notes, avis et nombres de ventes sous forme d’enregistrements normalisés.

TikTok Shop Products API

Une URL de boutique
Meilleures ventes ou nouveautés
20–2 000 produits demandés
Produits normalisés
0,7 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 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ètresObligatoireDescription
urlObligatoireURL publique obligatoire d’une boutique TikTok Shop de la forme /shop/store/{slug}/{numeric_shop_id} ; une tâche accepte une seule boutique.
results_limitFacultatifNombre 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_byFacultatifTri 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.
regionFacultatifRé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.

  1. Préparez une URL /shop/store/{slug}/{numeric_shop_id} prise en charge et choisissez les valeurs de results_limit, sort_by et region.
  2. Envoyez la requête en POST à /v1/tiktok-shop/products et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

TikTok Shop Products API — FAQ

TikTok Shop Products API collecte les produits publics d’une URL de boutique TikTok Shop prise en charge. Elle renvoie l’identité normalisée du produit, le contexte du vendeur, les prix, les images, les catégories, les données de SKU, les notes, les nombres d’avis et de ventes ainsi que l’heure de collecte.

url doit appartenir à tiktok.com ou à un sous-domaine TikTok et correspondre à /shop/store/{slug}/{numeric_shop_id}. La requête accepte aussi results_limit de 20 à 2 000, sort_by valant top ou new_releases, et une valeur de region documentée.

top demande l’ordre des meilleures ventes de la source, tandis que new_releases demande l’ordre des nouveautés les plus récentes. Ce sont des modes de tri de la source, qui ne garantissent ni rentabilité, ni statut de tendance, ni classement complet de l’inventaire.

Chaque ligne normalisée peut contenir l’identité du produit et du vendeur, une URL canonique, le titre ou la description, les images, les prix, la remise, la note, le nombre d’avis, le nombre de ventes, le statut, les catégories, les SKU, l’URL d’entrée, la région et l’heure de collecte. Les compteurs de boutique extérieurs aux lignes de produit ne font pas partie de la spécification de l’enregistrement normalisé.

results_limit est un maximum, pas un nombre garanti. La collecte s’arrête lorsque la région sélectionnée n’expose plus de produits ni de curseur, et les ID de produit exposés en double ne sont enregistrés qu’une fois par tâche.

Une fois la tâche réussie, lisez data.results.items depuis GET /v1/tasks/{task_id}. Tant que has_more vaut true, transmettez next_cursor au même endpoint de tâche jusqu’à ce que has_more passe à false.

Chaque enregistrement de produit renvoyé coûte 0,7 crédit SocQ. L’estimation de la requête repose sur results_limit, ou sur 100 s’il est omis, et un jeu de résultats vide n’entraîne aucun frais de résultat.