tiktok-shop/
product-reviews

Collectez les avis publics de TikTok Shop à partir de l’URL PDP d’un produit, avec texte de l’avis, notes, détails de l’auteur, images, SKU et contexte d’achat sous forme d’enregistrements normalisés.

TikTok Shop Product Reviews API

URL PDP d’un seul produit
Texte et notes d’avis publics
SKU et contexte d’achat
Collecte selon la région
0,3 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 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è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.
results_limitFacultatifNombre 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.
regionFacultatifRé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.

  1. 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.
  2. Envoyez la requête en POST à /v1/tiktok-shop/product-reviews et conservez le task_id renvoyé.
  3. Interrogez GET /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/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 true

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

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.

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 Reviews API — FAQ

TikTok Shop Product Reviews API récupère les avis clients publics associés à l’URL PDP d’un produit TikTok Shop pris en charge. Elle renvoie le texte normalisé des avis, les notes, les détails des auteurs, les images, les horodatages, le contexte de produit et de SKU, les pays et les indicateurs explicites de statut d’achat.

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

Ces champs ne rapportent que les valeurs explicites fournies avec l’avis public. Lorsque l’un d’eux est absent, considérez sa valeur comme inconnue plutôt que false, et ne déduisez ni vérification d’achat ni statut d’incitation.

results_limit est un maximum, pas un nombre garanti. La collecte s’arrête lorsque le flux d’avis disponible est épuisé, à une limite has_more en amont ou à la limite demandée, et un produit supprimé, indisponible, restreint à une région ou inaccessible publiquement peut ne produire aucun enregistrement.

Chaque avis enregistré coûte 0,3 crédit SocQ, y compris chaque avis unique stocké sur l’ensemble des pages de la source. Une tâche sans avis enregistré n’entraîne aucun frais de résultat.