Tmall Keyword Search Advanced
Search Tmall by keyword and collect product listings with prices, sales text, shops, and images.
Source · en-USRevenir à la traduction
Aperçu
Keyword searches on Tmall often mix official products, accessories, and lookalike listings behind the same buying intent. Collecting those search cards in one place makes it easier to review the visible assortment without losing the titles, shops, and images needed for a closer look.
This collection keeps listing details together with the search keyword that produced them. It is a starting point for assortment research and price-text comparison, not a replacement for opening a product page or confirming purchase conditions with a shop.
Data notes
The data describes product cards collected from Tmall keyword search. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated product identifiers are consolidated across the delivered pages. You can start collection from a specified page; if omitted, collection starts from page 1.
Product titles, price text, sales count text, and shop names retain their source values. Price is not converted into another currency, and no assumptions are made about taxes, delivery charges, or promotional conditions. The sales measurement period and the time zone of Collection time are not specified.
Missing brand, review count, platform, or listing status values remain missing rather than being inferred from a product title. A blank preview does not assert that the corresponding source value is an empty string. The collection should not be treated as a verified catalog of official Tmall products or a quotation for a particular order.
What the results look like
Each row represents a product card from Tmall keyword search. Quoted Price and Sales count values are text, not converted numbers.
| Product ID | Product title | Price | Sales count | Shop name | Keyword |
|---|---|---|---|---|---|
| 627049150327 | 闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air | "48.39" | "10万+" | 闪魔旗舰店 | iphone 18 pro max |
| 654826062393 | 倍思新无界膜适用苹果iPhone18钢化膜AR抗反射17ProMax保护膜16Pro无尘仓15手机贴膜14全屏13覆盖12防指纹11 | "91.96" | "10万+" | baseus倍思旗舰店 | iphone 18 pro max |
Additional columns include Image URL, Shop ID, Collection time, and List position.
Use cases
- Compare an assortment: group Product title by recurring product or accessory terms, then use Product ID and Shop name to inspect the distinct listings behind each group.
- Review displayed pricing: compare Price for listings with similar Product title wording, keeping the original price text and checking purchase conditions before drawing conclusions.
- Prepare a research shortlist: combine Keyword, Product title, Image URL, and Shop name to identify relevant candidates, and retain Collection time so later reviews can distinguish collection snapshots.
Périmètre et limites
One keyword per run; the requested collection target is 1-2,000 products, not a strict result limit. Results are returned in complete source pages of about 48 products and may include fewer or more than requested. Fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness.
- Adapté pour
- Find Tmall search listings for keyword-based product research and assortment comparison.
- À ne pas utiliser pour
- Do not use this for product-page details, reviews, guaranteed real-time quotes, or a strictly capped result count.
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.
- 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
- 2For rejected input or credentials, correct the input or access configuration before retrying.
- 3An empty result does not by itself mean that the source explicitly reported no data. Partial success may yield an incomplete collection; reaching the fetch protection capacity also requires a completeness check.
Entrée
Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.
- Search keyword
keywordRequisstringEnter one Tmall product search keyword, from 1 to 512 characters.Exempleiphone 18 pro max - Expected product count
target_countRequisstringEnter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; results are returned in complete source pages of about 48 products, so the actual count can be lower or higher.Exemple25 - Collection sort order
sortFacultatifstring(enum)Choose how products are ordered during collection; the default is Default. Delivered results remain in ascending collection-time order.Valeurs possiblesDefault0Sales: high to low2Price: low to high51Price: high to low52Défaut0 - Starting page
startPageFacultatifstringEnter a positive integer page number to start collection from; if omitted, collection starts from page 1.Défaut1Exemple1
Sortie
Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.
- Product ID
spu_idstringTmall product identifier.Exemple627049150327 - Product title
product_titlestringProduct title as collected, without translation.Exemple闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air - Price
pricestringPrice text as collected; no currency or numeric conversion is applied.Exemple48.39 - Sales count
sale_countstringSales count text as collected; the measurement period is not specified.Exemple10万+
Exemple de données
Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.
{
"spu_id": "627049150327",
"product_title": "闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air",
"price": "48.39",
"sale_count": "10万+",
"shop_id": "793375733",
"shop_name": "闪魔旗舰店",
"image_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/793375733/O1CN01VFo3XC93RRC2vH2e_!!4611686018427384821-0-item_pic.jpg",
"keyword": "iphone 18 pro max",
"biz_id": "iphone 18 pro max",
"brand_name": "<brand_name>",
"rate_count": "<rate_count>",
"platform": "<platform>",
"status": "<status>",
"list_index": "0",
"now_page": "1",
"crawl_time": "2026-10-13T16:50:27",
"task_item": "iphone 18 pro max",
"task_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/tmall-keyword-search-advanced",
"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. (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
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 48 enregistrements ; toute unité incomplète est arrondie à 48 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.