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ètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur TikTok public obligatoire. Une tâche accepte une seule valeur, avec ou sans @ initial. |
results_limit | Facultatif | Plafond de produits de vitrine uniques demandés, de 20 à 2 000. Vaut 100 par défaut. |
region | Facultatif | Ré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.
- Préparez un nom d’utilisateur TikTok public, choisissez une region prise en charge et fixez results_limit entre 20 et 2 000.
- Envoyez la requête en POST à /v1/tiktok-shop/user-showcase et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- 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 trueCas 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.
API associées
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.