tiktok-shop/
search

Recherchez des produits TikTok Shop publics par mot-clé et région de marché, avec champs normalisés de produit, vendeur, prix, médias, note, avis et nombre de ventes.

TikTok Shop Search API

Découverte de produits
Catalogues régionaux
Signaux commerciaux
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 Search

Les résultats de TikTok Shop Search sont des produits publics correspondant à un mot-clé sur un marché choisi, avec identité du produit et du vendeur, prix, images, notes, nombres d’avis et nombres de ventes. Ces enregistrements commerciaux servent à découvrir des produits par région, à comparer des prix, à étudier des vendeurs et à produire des instantanés de marché reproductibles.

Fonctionnalités de la TikTok Shop Search API

  • Mot-clé et marchéAssociez une requête produit à l’une des 16 valeurs de region prises en charge pour interroger le catalogue public du marché visé.
  • Collecte bornée et uniqueDemandez de 20 à 2 000 résultats, les pages collectées étant dédoublonnées selon l’identité publique du produit.
  • Identité du produit et du vendeurRenvoie les ID de produit, les titres, les descriptions, les liens canoniques et les informations exposées sur le vendeur ou la boutique.
  • Prix et signaux commerciaux visiblesConserve le prix de vente, le prix d’origine, la devise, la remise, la note, le nombre d’avis et le nombre de ventes lorsqu’ils sont exposés.
  • Médias et contexte du produitGarde avec chaque enregistrement les images publiques, les catégories, les structures de SKU, le statut, la requête de recherche, la région et l’heure de collecte.

Paramètres de la TikTok Shop Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé ou expression de produit obligatoire et non vide.
results_limitFacultatifPlafond de résultats 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 Search API

Choisissez une expression de produit concrète et un marché, puis envoyez une requête de recherche asynchrone.

  1. Renseignez une query non vide, 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/search 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. Si has_more vaut true, poursuivez avec next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","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 Search API

  • Découverte régionale de produits : Cartographiez les produits publics correspondant à une catégorie, un besoin, une marque ou une expression de produit sur un marché choisi.
  • Comparaison des prix et des remises : Comparez les prix de vente, prix d’origine, devises et remises disponibles pour les produits renvoyés.
  • Comparaison de réputation et de demande : Comparez les notes, nombres d’avis et nombres de ventes exposés, sans transformer les métriques manquantes en zéro.
  • Présélection de produits et de boutiques : Appuyez-vous sur les liens produit, l’identité du vendeur, les images, les catégories et le contexte de SKU pour choisir les candidats à examiner plus en détail.

Conseils d’expert pour la TikTok Shop Search API

  • Stockez toujours query et region ensemble, car une même expression peut renvoyer des catalogues publics différents.
  • Réglez results_limit sur le volume voulu et suivez next_cursor jusqu’à ce que has_more vaille false pour lire le résultat complet de la tâche.
  • Considérez un prix, une note, un nombre d’avis ou un nombre de ventes manquant comme indisponible, et non comme zéro.
  • Conservez search_query et collected_at avec chaque enregistrement pour que les instantanés régionaux restent reproductibles.
  • Transmettez l’URL PDP d’un produit choisi à TikTok Shop Product API lorsque vous avez besoin d’un enrichissement de détail à jour.

En complément de la TikTok Shop Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Shop.

  • 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 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 Search Suggestions API — Obtenez jusqu’à 20 complétions de recherche classées que le TikTok Shop suggère pour le début d’une requête d’achat sur un marché.

Explorer d’autres plateformes

Combinez les données TikTok Shop avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Shop Search API — FAQ

TikTok Shop Search API trouve des produits accessibles publiquement à partir d’un mot-clé et d’une région de marché. 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.

Non. TikTok Shop Search est un endpoint commercial indépendant pour les produits publics, tandis que TikTok Search découvre les vidéos sociales publiques et les contenus de créateurs.

query est obligatoire, results_limit est un entier de 20 à 2 000 valant 100 par défaut, et region vaut US par défaut.

Les valeurs prises en charge sont US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP et IE. La disponibilité des produits hors des États-Unis peut varier selon le catalogue public de chaque marché.

Les résultats peuvent contenir l’identité du produit et du vendeur, l’URL canonique, 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, la région, la requête et l’heure de collecte.

Le marché public choisi peut compter moins de produits correspondants, et la collecte s’arrête quand plus aucune page source n’est disponible après déduplication. Une tâche réussie peut donc ne contenir aucun élément, ou moins que demandé.

Interrogez /v1/tasks/{task_id}, lisez data.results.items après le succès, puis demandez la page suivante de résultats de la tâche avec next_cursor tant que has_more vaut true.

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