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

Collecte de données E-commerce & Retail TikTok Products

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 l'auteur. 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.

Champ	Nom métier	Type	Requis	Défaut	Énum / Contraintes	Exemple	Description
keyword	Mot-clé de recherche	string	Oui	—	—	milk	Marque, produit ou catégorie à rechercher sur TikTok Shop. Chaque tâche accepte un mot-clé de 1 à 512 caractères.
crawl_count	Nombre de résultats attendu	integer	Oui	—	1–300	30	Nombre 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.

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

Champ	Nom métier	Type	Exemple	Description
biz_id	ID métier	string	milk	Identifiant de regroupement métier renvoyé avec la fiche collectée ; vide si aucune valeur n'est renvoyée.
brand_name	Nom de marque	string	Micro Ingredients	Nom de marque affiché sur la fiche produit ; vide si aucune valeur n'est renvoyée.
collect_time	Horodatage de collecte	string	1789121807761	Heure de collecte sous forme de chaîne d'horodatage en millisecondes ; vide si aucune valeur n'est renvoyée.
crawl_time	Heure de collecte	string	2026-09-11T18:16:47	Heure de collecte de la fiche ; la source ne précise pas de fuseau horaire.
created_at	Horodatage de création	string	1789121807761	Heure de création de l'enregistrement sous forme de chaîne d'horodatage en millisecondes ; vide si aucune valeur n'est renvoyée.
image_url	Image produit	string	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	URL de l'image principale du produit sur la fiche ; vide si aucune valeur n'est renvoyée.
keyword	Mot-clé correspondant	string	milk	Mot-clé de recherche associé à cette fiche produit.
page_num	Page de résultats	string	1	Numéro de page des résultats de recherche sous forme de chaîne ; vide si aucune valeur n'est renvoyée.
platform_code	Code plateforme	string	tiktokShop	Code de la plateforme source renvoyé avec la fiche.
price	Prix	string	41.54	Prix affiché sous forme de chaîne brute, sans champ de devise séparé ; vide si aucune valeur n'est renvoyée.
product_id	ID produit	string	1729435358486827693	Identifiant unique et stable du produit TikTok Shop.
product_title	Titre du produit	string	Micro Ingredients Whole Milk Powder, 4lbs, Made in USA	Titre du produit affiché sur la fiche TikTok Shop.
rank_index	Rang de recherche	integer	0	Rang du produit dans la liste de recherche, à partir de 0 ; vide si aucune valeur n'est renvoyée.
rating_count	Nombre d'avis	string	3185	Nombre d'avis sous forme de chaîne numérique ; vide si aucune valeur n'est renvoyée.
sale_count	Nombre de ventes	string	23284	Nombre de ventes public sous forme de chaîne numérique ; vide si aucune valeur n'est renvoyée.
shop_id	ID boutique	string	7494949083499694765	Identifiant unique de la boutique TikTok Shop ; vide si aucune valeur n'est renvoyée.
shop_name	Nom de la boutique	string	Micro Ingredients	Nom de la boutique associée à la fiche produit.
status_code	Code de statut	string	—	Code de statut produit brut ; vide si aucune valeur n'est renvoyée.
source_item	Élément source	string	milk	Élément mot-clé de la collecte qui a produit cet enregistrement.
no_data	Marqueur sans données	boolean	false	Indique si cet élément de recherche n'a produit aucun produit correspondant.

Schema de l'enregistrement

La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "ID métier",
      "description": "Identifiant de regroupement métier renvoyé avec la fiche collectée ; vide si aucune valeur n'est renvoyée.",
      "prefill": "milk"
    },
    "brand_name": {
      "type": "string",
      "title": "Nom de marque",
      "description": "Nom de marque affiché sur la fiche produit ; vide si aucune valeur n'est renvoyée.",
      "prefill": "Micro Ingredients"
    },
    "collect_time": {
      "type": "string",
      "title": "Horodatage de collecte",
      "description": "Heure de collecte sous forme de chaîne d'horodatage en millisecondes ; vide si aucune valeur n'est renvoyée.",
      "prefill": "1789121807761"
    },
    "crawl_time": {
      "type": "string",
      "title": "Heure de collecte",
      "description": "Heure de collecte de la fiche ; la source ne précise pas de fuseau horaire.",
      "prefill": "2026-09-11T18:16:47"
    },
    "created_at": {
      "type": "string",
      "title": "Horodatage de création",
      "description": "Heure de création de l'enregistrement sous forme de chaîne d'horodatage en millisecondes ; vide si aucune valeur n'est renvoyée.",
      "prefill": "1789121807761"
    },
    "image_url": {
      "type": "string",
      "title": "Image produit",
      "description": "URL de l'image principale du produit sur la fiche ; vide si aucune valeur n'est renvoyée.",
      "prefill": "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": {
      "type": "string",
      "title": "Mot-clé correspondant",
      "description": "Mot-clé de recherche associé à cette fiche produit.",
      "prefill": "milk"
    },
    "page_num": {
      "type": "string",
      "title": "Page de résultats",
      "description": "Numéro de page des résultats de recherche sous forme de chaîne ; vide si aucune valeur n'est renvoyée.",
      "prefill": "1"
    },
    "platform_code": {
      "type": "string",
      "title": "Code plateforme",
      "description": "Code de la plateforme source renvoyé avec la fiche.",
      "prefill": "tiktokShop"
    },
    "price": {
      "type": "string",
      "title": "Prix",
      "description": "Prix affiché sous forme de chaîne brute, sans champ de devise séparé ; vide si aucune valeur n'est renvoyée.",
      "prefill": "41.54"
    },
    "product_id": {
      "type": "string",
      "title": "ID produit",
      "description": "Identifiant unique et stable du produit TikTok Shop.",
      "prefill": "1729435358486827693"
    },
    "product_title": {
      "type": "string",
      "title": "Titre du produit",
      "description": "Titre du produit affiché sur la fiche TikTok Shop.",
      "prefill": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA"
    },
    "rank_index": {
      "type": "integer",
      "title": "Rang de recherche",
      "description": "Rang du produit dans la liste de recherche, à partir de 0 ; vide si aucune valeur n'est renvoyée.",
      "prefill": 0
    },
    "rating_count": {
      "type": "string",
      "title": "Nombre d'avis",
      "description": "Nombre d'avis sous forme de chaîne numérique ; vide si aucune valeur n'est renvoyée.",
      "prefill": "3185"
    },
    "sale_count": {
      "type": "string",
      "title": "Nombre de ventes",
      "description": "Nombre de ventes public sous forme de chaîne numérique ; vide si aucune valeur n'est renvoyée.",
      "prefill": "23284"
    },
    "shop_id": {
      "type": "string",
      "title": "ID boutique",
      "description": "Identifiant unique de la boutique TikTok Shop ; vide si aucune valeur n'est renvoyée.",
      "prefill": "7494949083499694765"
    },
    "shop_name": {
      "type": "string",
      "title": "Nom de la boutique",
      "description": "Nom de la boutique associée à la fiche produit.",
      "prefill": "Micro Ingredients"
    },
    "status_code": {
      "type": "string",
      "title": "Code de statut",
      "description": "Code de statut produit brut ; vide si aucune valeur n'est renvoyée."
    },
    "source_item": {
      "type": "string",
      "title": "Élément source",
      "description": "Élément mot-clé de la collecte qui a produit cet enregistrement.",
      "prefill": "milk"
    },
    "no_data": {
      "type": "boolean",
      "title": "Marqueur sans données",
      "description": "Indique si cet élément de recherche n'a produit aucun produit correspondant.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": 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.

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 config

{
  "mcpServers": {
    "super_ig__tiktok-shop-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Voir mes API Keys →

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. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)

detail.access.mcp.composeHint

Tarifs

30 enregistrements renvoyés

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 enregistrement ; toute unité incomplète est arrondie à 30 enregistrement.

0,005 $US/ 30 enregistrement

Per task submitted

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution

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édits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple

Les paramètres sont validés par rapport à l'input.schema avant la soumission

Mot-clé de recherchekeyword*Marque, produit ou catégorie à rechercher sur TikTok Shop. Chaque tâche accepte un mot-clé de 1 à 512 caractères.

Nombre de résultats attenducrawl_count*Nombre 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.

Veuillez d'abord renseigner les paramètres requis

À partir de 0,005 $US / 30 enregistrement