tiktok-shop/
user-showcase

Collectez les produits affichés dans la vitrine Shop d’un utilisateur TikTok public à partir de son nom d’utilisateur et d’une région, avec champs de vendeur, prix, médias, note, avis et nombre de ventes.

TikTok Shop User Showcase API

Nom d’utilisateur en entrée
Produits de la vitrine
Catalogues régionaux
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 User Showcase

Les vitrines TikTok Shop sont des présentations de produits rattachées à des profils TikTok publics, avec identité du produit et du vendeur, prix, médias, notes, nombres d’avis et nombres de ventes lorsqu’ils sont exposés. Ces signaux commerciaux servent à examiner un assortiment, à produire des instantanés régionaux, à comparer des produits et à enrichir des jeux de données de recherche.

Fonctionnalités de la TikTok Shop User Showcase API

  • Collecte de la vitrine d’un seul nom d’utilisateurCollectez les produits publics affichés pour un nom d’utilisateur TikTok, avec ou sans @ initial.
  • Choix de la région de marchéChoisissez l’une des 16 valeurs de region prises en charge pour que la collecte cible le marché TikTok Shop public voulu.
  • Résultats de produits uniques et bornésDemandez de 20 à 2 000 produits de la vitrine, les pages collectées étant dédoublonnées selon l’identité publique du produit.
  • Contexte normalisé du produit et du vendeurRenvoie les ID de produit, titres, descriptions, liens canoniques, images, champs du vendeur, prix, catégories et structures de SKU lorsqu’ils sont exposés.
  • Signaux commerciaux visibles et limites du publicConserve les notes, nombres d’avis, nombres de ventes, statut, région et heure de collecte disponibles, et laisse vides les champs publics indisponibles.

Paramètres de la TikTok Shop User Showcase API

ParamètresObligatoireDescription
usernameObligatoireNom d’utilisateur TikTok public obligatoire. Une tâche accepte une seule valeur, avec ou sans @ initial.
results_limitFacultatifPlafond de produits de vitrine uniques demandés, de 20 à 2 000. Vaut 100 par défaut.
regionFacultatifRégion de marché : US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP ou IE. Vaut US par défaut.

Comment utiliser la TikTok Shop User Showcase API

Envoyez un nom d’utilisateur public et un marché sous forme de tâche asynchrone, puis lisez les produits de vitrine enregistrés grâce à la pagination par curseur.

  1. Préparez un nom d’utilisateur TikTok public, choisissez une region prise en charge et fixez results_limit entre 20 et 2 000.
  2. Envoyez la requête en POST à /v1/tiktok-shop/user-showcase et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
  4. Lisez data.results.items ; tant que has_more vaut true, continuez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"mrtiktokreviews","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 User Showcase API

  • Examiner l’assortiment de la vitrine d’un utilisateur : Servez-vous des ID de produit, titres, liens, contexte du vendeur, images et catégories pour inspecter les produits publics affichés pour un nom d’utilisateur.
  • Comparer les prix et les signaux de demande visibles : Comparez les prix, devises, remises, notes, nombres d’avis et nombres de ventes disponibles pour les produits de vitrine renvoyés.
  • Créer des instantanés régionaux de vitrines : Stockez input_username, region, l’identité du produit, les champs commerciaux publics et collected_at pour des revues ponctuelles reproductibles.
  • Enrichir un jeu de données de recherche produit : Ajoutez URL de produit canoniques, identité du vendeur, médias, catégories, contexte de SKU et métriques visibles à un jeu de recherche existant organisé par nom d’utilisateur.

Conseils d’expert pour la TikTok Shop User Showcase API

  • Gardez une orthographe de nom d’utilisateur stable d’une exécution à l’autre ; l’endpoint accepte @handle ou handle et enregistre le nom d’utilisateur normalisé avec chaque produit.
  • Choisissez le marché qui correspond au catalogue voulu, car region vaut US par défaut et la disponibilité publique hors des États-Unis peut varier.
  • Réglez results_limit entre 20 et 2 000 selon la couverture nécessaire, au lieu de supposer que chaque vitrine contient les 100 produits par défaut.
  • Après le succès, suivez next_cursor tant que has_more vaut true afin que la pagination des résultats de la tâche ne laisse aucun produit enregistré sans lecture.
  • Dédoublonnez les instantanés par id de produit et considérez les tâches vides, ou les champs de vendeur, de prix, de médias, de catégorie, de SKU et de métriques manquants, comme des issues valides d’une source publique.

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

TikTok Shop User Showcase API collecte les produits Shop affichés publiquement pour un nom d’utilisateur TikTok et un marché choisis. Elle renvoie des champs normalisés de produit, de vendeur, de prix, de médias, de catégorie, de SKU, de note, de nombre d’avis et de nombre de ventes lorsqu’ils sont exposés.

Envoyez une seule chaîne non vide. mrtiktokreviews et @mrtiktokreviews sont tous deux acceptés, et le @ initial est supprimé avant la collecte.

results_limit accepte les entiers de 20 à 2 000 et vaut 100 par défaut. region vaut US par défaut et accepte aussi GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP et IE.

Les résultats peuvent contenir l’identité du produit et du vendeur, l’URL canonique, le titre, la description, les images, le détail des prix, les catégories, les SKU, le statut, la note, le nombre d’avis, le nombre de ventes, le nom d’utilisateur en entrée, la région et l’heure de collecte.

Un profil public peut n’avoir aucun produit de vitrine disponible sur le marché choisi, et la source peut omettre les valeurs de vendeur, de prix, de médias, de catégorie, de SKU ou de métriques. Une tâche réussie peut donc ne contenir aucun élément, ou des enregistrements dont les champs facultatifs sont vides.

Après le succès de la tâche, lisez data.results.items depuis /v1/tasks/{task_id}, puis passez next_cursor pour obtenir la page suivante tant que has_more vaut true.

Chaque produit de vitrine normalisé renvoyé coûte 0,7 crédit SocQ. Un résultat vide n’entraîne aucun frais de résultat.