tiktok-shop/
product

Récupérez un produit TikTok Shop public à partir d’une URL PDP, avec identité, vendeur, prix, notes et ventes visibles, médias, catégories et SKU dans un seul enregistrement normalisé.

TikTok Shop Product API

Détail de produit public
URL PDP en entrée
Enregistrement normalisé unique
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 Product

Les produits TikTok Shop sont des pages de détail publiques, avec identité, vendeur, prix, médias, catégorie, variantes, note, nombre d’avis et nombre de ventes. Ces champs servent à enrichir des fiches produit, à étudier un catalogue, à contrôler la présentation commerciale et à comparer des états à un instant donné.

Fonctionnalités de la TikTok Shop Product API

  • Consultation du détail d’une seule PDPEnvoyez une URL PDP TikTok Shop publique prise en charge et recevez au plus un enregistrement de produit normalisé : l’endpoint convient pour enrichir un article connu, pas pour découvrir des produits.
  • Vendeur, prix et signaux commerciaux visiblesL’enregistrement conserve l’identité exposée du vendeur, le prix de vente et le prix d’origine, la devise, la remise, la note, le nombre d’avis et le nombre de ventes, pour une évaluation directe champ par champ.
  • Médias, catégorie et contexte de SKULes enregistrements renvoyés incluent les images de produit exposées avec leurs dimensions, ainsi que les structures de catégorie et de SKU ou de variantes de la page produit publique.

Paramètres de la TikTok Shop Product API

ParamètresObligatoireDescription
urlObligatoireURL publique TikTok Shop obligatoire de la forme /shop/pdp/{numeric_id} ou /shop/pdp/{slug}/{numeric_id} ; une tâche accepte un seul produit.
regionFacultatifRégion de marché TikTok Shop facultative ; vaut US par défaut, tandis que la disponibilité des produits peut varier dans les autres régions acceptées.

Comment utiliser la TikTok Shop Product API

Envoyez l’URL d’un produit pris en charge, conservez l’ID de la tâche asynchrone, puis lisez le produit normalisé une fois la tâche réussie.

  1. Envoyez une requête POST à /v1/tiktok-shop/product avec une url PDP prise en charge et, si besoin, une region.
  2. Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded ou failed.
  3. Après un succès, lisez data.results.items et ne suivez next_cursor que si has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

Cas d’usage de la TikTok Shop Product API

  • Enrichissement de résultats de recherche ou de catalogue : Servez-vous d’une URL PDP connue pour ajouter vendeur, prix, note, médias, catégorie et SKU à un produit sélectionné dans une recherche ou un catalogue de boutique.
  • Comparaison d’instantanés des signaux produit : Comparez prix de vente, prix d’origine, remise, note, nombre d’avis et nombre de ventes collectés dans des enregistrements de produit pris à différents instants.
  • Revue des catégories et des variantes : Inspectez les structures de catégorie, d’image et de SKU exposées pour voir comment un produit public est organisé et présenté.

Conseils d’expert pour la TikTok Shop Product API

  • Vérifiez avant l’envoi que l’entrée est une URL PDP tiktok.com complète avec un ID de produit numérique, afin d’éviter une requête rejetée.
  • Laissez region sur US, sauf si le produit appartient à un autre marché accepté, et voyez dans un résultat vide hors US une possible limite de disponibilité.
  • N’envoyez pas results_limit : une tâche accepte une seule URL de produit et renvoie au plus un enregistrement normalisé.
  • Traitez les champs nullables de vendeur, de prix, de signaux, de médias, de catégorie et de SKU comme un instantané de la page publique, et gérez une tâche réussie sans élément sans créer de produit factice.

En complément de la TikTok Shop Product 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 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 Product API — FAQ

TikTok Shop Product API récupère un produit public à partir d’une URL PDP TikTok Shop prise en charge. Elle renvoie l’identité, le vendeur, le prix, la note, les signaux d’avis et de ventes, les médias, les catégories et les données de SKU, le tout normalisé.

Utilisez une URL tiktok.com ou d’un sous-domaine TikTok dont le chemin correspond à /shop/pdp/{numeric_id} ou /shop/pdp/{slug}/{numeric_id}. Les autres URL TikTok sont rejetées comme entrée invalide.

Non. Chaque tâche accepte une seule URL de produit, n’accepte pas results_limit et renvoie au plus un enregistrement de produit normalisé.

region vaut US par défaut et accepte US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP et IE. La disponibilité des produits hors des États-Unis peut varier.

Une URL PDP valide peut ne produire aucun enregistrement lorsque le produit a été retiré, n’est pas disponible dans la région choisie ou n’est pas exposé sur la page publique.

Chaque enregistrement de produit renvoyé coûte 0,7 crédit SocQ. Une tâche qui ne renvoie aucun produit n’entraîne aucun frais de résultat.