logo
EN

Tmall Keyword Search Advanced

Search Tmall by keyword and collect product listings with prices, sales text, shops, and images.

Data collectionE-commerce & RetailTmallProducts
Developer
super_ig
Pricing
From $0.12 / 48 records
Last updated
2026-10-19

Overview

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 IDProduct titlePriceSales countShop nameKeyword
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.

Scope and boundaries

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.

  • Good for
  • Find Tmall search listings for keyword-based product research and assortment comparison.
  • Do not use for
  • Do not use this for product-page details, reviews, guaranteed real-time quotes, or a strictly capped result count.

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
  2. 2For rejected input or credentials, correct the input or access configuration before retrying.
  3. 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.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Search keywordkeywordRequiredstring
    Enter one Tmall product search keyword, from 1 to 512 characters.
    Exampleiphone 18 pro max
  • Expected product counttarget_countRequiredstring
    Enter 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.
    Example25
  • Collection sort ordersortOptionalstring(enum)
    Choose how products are ordered during collection; the default is Default. Delivered results remain in ascending collection-time order.
    Allowed valuesDefault0Sales: high to low2Price: low to high51Price: high to low52Default0
  • Starting pagestartPageOptionalstring
    Enter a positive integer page number to start collection from; if omitted, collection starts from page 1.
    Default1Example1

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Product IDspu_idstring
    Tmall product identifier.
    Example627049150327
  • Product titleproduct_titlestring
    Product title as collected, without translation.
    Example闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air
  • Pricepricestring
    Price text as collected; no currency or numeric conversion is applied.
    Example48.39
  • Sales countsale_countstring
    Sales count text as collected; the measurement period is not specified.
    Example10万+

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "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
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tmall-keyword-search-advanced",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
View my API Keys →

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

48 returned records

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 48 records; any partial unit is rounded up to 48 records.

$0.12/ 48 records
Per task submitted

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.12 / 48 records