TikTok Shop Product Reviews
Les avis sur les produits TikTok Shop sont des retours clients publics comprenant texte, notes, noms des auteurs, images, horodatages, détails de SKU, pays et indicateurs explicites de statut d’achat. Ces champs servent à analyser les retours sur un produit, à comparer variantes et régions, et à alimenter des workflows d’examen d’avis attentifs aux preuves.
Fonctionnalités de la TikTok Shop Product Reviews API
- Un produit, avec sa portée régionaleEnvoyez l’URL PDP publique d’un produit pris en charge avec une région de marché, puis collectez les avis uniques exposés pour ce produit jusqu’à la limite demandée.
- Contenu, note, auteur et médias de l’avisChaque enregistrement normalisé conserve le texte de l’avis tel qu’il est exposé, la note numérique, l’identité de l’auteur, les images, la date de publication, l’URL du produit et l’heure de collecte.
- Contexte de produit, de SKU, de pays et d’achatLes avis gardent les identifiants de produit et de SKU, les spécifications de variante, le pays de l’avis ainsi que les indicateurs explicites d’achat vérifié ou d’avis incité lorsqu’ils sont fournis.
Paramètres de la TikTok Shop Product Reviews 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. |
results_limit | Facultatif | Nombre maximal d’avis uniques à enregistrer sur l’ensemble des pages de la source ; vaut 100 par défaut et accepte les entiers de 20 à 2 000. |
region | Facultatif | Région de marché TikTok Shop ; vaut US par défaut, et la disponibilité publique des produits ou des avis peut varier dans les autres régions acceptées. |
Comment utiliser la TikTok Shop Product Reviews API
Envoyez l’URL d’un produit pris en charge, suivez la tâche asynchrone, puis lisez les avis normalisés grâce à la pagination par curseur.
- Préparez l’url PDP d’un produit TikTok Shop pris en charge, un results_limit de 20 à 2 000 et la région de marché du produit.
- Envoyez la requête en POST à /v1/tiktok-shop/product-reviews et conservez le task_id renvoyé.
- Interrogez GET /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/product-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"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 Product Reviews API
- Analyse des retours sur un produit : Servez-vous du texte des avis, des notes numériques, des horodatages et de l’identité du produit pour examiner les retours publics renvoyés pour un produit connu.
- Comparaison des retours par SKU et par région : Regroupez les enregistrements par spécification de SKU ou par pays de l’avis, puis comparez texte et notes sans deviner les valeurs manquantes.
- Contexte d’achat et médias des avis : Examinez les images fournies par les clients et segmentez les enregistrements selon les indicateurs explicites d’achat vérifié ou d’avis incité lorsque ces valeurs existent.
Conseils d’expert pour la TikTok Shop Product Reviews 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, car les URL de profil, de vidéo, de boutique et les autres URL TikTok sont rejetées.
- Choisissez la région qui correspond au marché du produit ; une URL valide peut ne renvoyer aucun avis public si le marché sélectionné n’expose ni le produit ni son flux d’avis.
- Réglez results_limit entre 20 et 2 000 pour la couverture de la collecte, puis suivez next_cursor jusqu’à ce que has_more vaille false afin de lire toutes les pages de résultats stockées.
- Considérez l’absence de texte d’avis, d’identité de l’auteur, de détails de SKU et d’indicateurs de statut d’achat comme une information inconnue ; un booléen manquant n’est pas false, et un enregistrement qui ne contient qu’une note reste valide.
API associées
En complément de la TikTok Shop Product Reviews 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 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.