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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL publique TikTok Shop obligatoire de la forme /shop/pdp/{numeric_id} ou /shop/pdp/{slug}/{numeric_id} ; une tâche accepte un seul produit. |
region | Facultatif | Ré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.
- Envoyez une requête POST à /v1/tiktok-shop/product avec une url PDP prise en charge et, si besoin, une region.
- Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded ou failed.
- 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 succeededCas 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.
API associées
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.