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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé ou expression de produit obligatoire et non vide. |
results_limit | Facultatif | Plafond de résultats 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 Search API
Choisissez une expression de produit concrète et un marché, puis envoyez une requête de recherche asynchrone.
- Renseignez une query non vide, choisissez une region prise en charge et fixez results_limit entre 20 et 2 000.
- Envoyez la requête en POST à /v1/tiktok-shop/search 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. 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 trueCas 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.
API associées
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é.