Fournissez une liste d'ID produit ou de SPU TikTok Shop et obtenez le titre, le prix, le vendeur, la livraison, les SKU et le statut de collecte
Recherche par mot-clé TikTok Shop
Indiquez un mot-clé TikTok Shop et un nombre de produits attendu pour obtenir les fiches US correspondantes, avec boutique, prix et signaux de ventes.
Traduit · fr-FRVoir le texte original
Aperçu
Les acheteurs découvrent vraiment les produits via la recherche par mot-clé TikTok Shop, mais la fiche publique est difficile à conserver comme jeu de données comparable : titres, prix, boutiques et rang bougent ensemble, et les captures d’écran ne survivent pas à l’analyse. Cette application transforme un mot-clé de recherche en liste structurée de produits TikTok Shop américains correspondants, pour que les équipes merchandising, marque et recherche voient ce qui apparaît actuellement pour ce terme.
Contrairement à l’ouverture d’une fiche produit déjà connue, la recherche par mot-clé montre quelles fiches occupent l’étagère pour une marque, une catégorie ou une phrase de campagne. Garder l’identité produit, les signaux commerciaux de la fiche et le contexte boutique sur la même ligne permet de comparer des termes, de suivre la présence d’une marque ou de constituer un ensemble de candidats sans copier les résultats à la main.
Notes sur les données
Chaque enregistrement est une fiche produit publique associée au mot-clé soumis sur TikTok Shop aux États-Unis. Les ID produit sont dédupliqués dans le jeu renvoyé. Mot-clé correspondant, ID métier et Élément source conservent le contexte de recherche et peuvent se répéter sur de nombreux produits de la même tâche. Les fiches reviennent dans un ordre stable croissant selon l’heure de collecte.
Le prix est le montant affiché sous forme de chaîne brute, sans champ de devise séparé. Horodatage de collecte et Horodatage de création sont des chaînes en millisecondes ; Heure de collecte n’a pas de fuseau horaire et ne doit pas être lue comme une horloge absolue entre régions. Le rang de recherche commence à 0. Le Marqueur sans données distingue un élément de recherche sans produits correspondants des lignes de fiche ordinaires.
La collecte couvre uniquement les fiches de recherche publiques aux États-Unis. Elle n’inclut pas les catalogues d’autres pays, les spécifications de fiche détail, les commentaires ni les données de commande.
À quoi ressemble un résultat
Chaque ligne est une fiche produit TikTok Shop associée au mot-clé de recherche, ou un marqueur sans données pour cette recherche.
| Titre du produit | ID produit | Prix | Nom de la boutique | Nombre de ventes | Rang de recherche |
|---|---|---|---|---|---|
| Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | 1729435358486827693 | 41.54 | Micro Ingredients | 23284 | 0 |
| Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons | 1729408858647663361 | 18.26 | Weee Asian Supermarket | 6714 | 1 |
Nom de marque, Image produit, Nombre d'avis, ID boutique, Heure de collecte et Marqueur sans données sont également disponibles lorsqu’ils sont fournis avec l’enregistrement.
Cas d’usage
- Pour le merchandising par mot-clé, groupez les lignes par Mot-clé correspondant et comparez Titre du produit, Prix et Nom de la boutique pour voir quelles fiches occupent l’étagère de recherche.
- Pour le suivi concurrentiel, triez par Rang de recherche et utilisez Nombre de ventes avec Nombre d'avis pour séparer les fiches très visibles des produits de longue traîne.
- Pour le suivi de marque, comparez Nom de marque à Nom de la boutique et ID produit afin de voir si les produits de marque sont vendus par la boutique de la marque ou par d’autres marchands.
- Pour le suivi sourcing, conservez ensemble ID produit, ID boutique et Image produit afin de rouvrir la même fiche plus tard sans refaire la recherche à la main.
Périmètre et limites
Un mot-clé de recherche TikTok Shop par tâche, pour un nombre attendu de 1 à 300; les résultats reviennent par lots complets de 30 et peuvent être arrondis; la couverture se limite aux fiches de recherche TikTok Shop US publiques.
- Adapté pour
- Lorsque vous avez besoin des produits TikTok Shop US qui apparaissent pour un mot-clé de marque, de produit ou de catégorie.
- Lorsque vous avez besoin d'une liste structurée reliant chaque fiche trouvée à sa boutique, son prix, son rang et ses signaux publics de ventes ou d'avis.
- À ne pas utiliser pour
- Lorsque vous avez besoin des spécifications complètes, des commentaires ou des données de commande d'une fiche détail.
- Lorsque vous avez besoin d'une consultation immédiate d'un seul enregistrement plutôt que d'une collecte par mot-clé en arrière-plan.
- Lorsque vous avez besoin de fiches TikTok Shop hors des États-Unis.
Gestion des échecs
Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.
- 1Si aucun enregistrement correspondant n'est renvoyé, essayez une expression plus courte ou plus large puis renvoyez la tâche.
- 2Conservez les enregistrements déjà obtenus après un succès partiel ; renvoyez la même saisie après un échec ou une expiration.
- 3Réessayez plus tard après une limitation de débit, une indisponibilité temporaire ou un délai d'attente.
- 4Si l'authentification échoue, vérifiez la clé API configurée dans l'environnement d'exécution.
Entrée
Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.
- Mot-clé de recherche
keywordRequisstringMarque, produit ou catégorie à rechercher sur TikTok Shop. Chaque tâche accepte un mot-clé de 1 à 512 caractères.Exemplemilk - Nombre de résultats attendu
crawl_countRequisintegerNombre attendu de fiches produits, de 1 à 300. Les résultats reviennent par lots complets de 30, le nombre réel peut donc être arrondi. Les lots incomplets sont tout de même facturés comme 30 enregistrements.Plage1–300Exemple30
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
- ID métier
biz_idstringIdentifiant de regroupement métier renvoyé avec la fiche collectée ; vide si aucune valeur n'est renvoyée.Exemplemilk - Nom de marque
brand_namestringNom de marque affiché sur la fiche produit ; vide si aucune valeur n'est renvoyée.ExempleMicro Ingredients - Horodatage de collecte
collect_timestringHeure de collecte sous forme de chaîne d'horodatage en millisecondes ; vide si aucune valeur n'est renvoyée.Exemple1789121807761 - Heure de collecte
crawl_timestringHeure de collecte de la fiche ; la source ne précise pas de fuseau horaire.Exemple2026-09-11T18:16:47
Exemple de données
Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.
{
"biz_id": "milk",
"brand_name": "Micro Ingredients",
"collect_time": "1789121807761",
"crawl_time": "2026-09-11T18:16:47",
"created_at": "1789121807761",
"image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
"keyword": "milk",
"page_num": "1",
"platform_code": "tiktokShop",
"price": "41.54",
"product_id": "1729435358486827693",
"product_title": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA",
"rank_index": 0,
"rating_count": "3185",
"sale_count": "23284",
"shop_id": "7494949083499694765",
"shop_name": "Micro Ingredients",
"status_code": "<status_code>",
"source_item": "milk",
"no_data": false
}Intégration
Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.
Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.
Config du client
Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Laissez l'IA tout configurer pour vous
Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)
detail.access.mcp.composeHint
Tarifs
Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 30 enregistrements ; toute unité incomplète est arrondie à 30 enregistrements.
Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.
Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.
Voir les créditsEssayer maintenant
Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.