logo
DE

Tmall Keyword Search

Give a Tmall search keyword and an expected count to get matching product listings with prices, sales counts, and shop details.

Original · en-USZur Übersetzung

DatenerfassungE-commerce & RetailTmallProducts
Entwickler
super_ig
Preise
Ab 0,02 $ / 10 Datensätze
Zuletzt aktualisiert
2026-10-19

Übersicht

Keyword searches on Tmall mix flagship stores, authorized sellers and accessory listings behind the same buying intent. Seeing those search-result cards together makes it easier to judge which products, shops and price points actually appear for a query, without opening every listing one by one.

This collection keeps the original product titles, displayed prices and sales text from Tmall search results. It is useful when assortment, ranking and list-page pricing are the input to a sourcing or competitive review, rather than replacing a product-detail check or a purchase decision.

Data notes

The data describes product cards collected from public Tmall keyword search results. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated SPU IDs are consolidated across the delivered pages.

Product title, Price and Sales count retain their source text. Price is not converted into another currency, and no assumptions are made about taxes, promotions or purchasing conditions. Business ID, Keyword and Submitted keyword can carry the same search phrase; none of them is a unique product identifier. Collect time and Creation timestamp are preserved as returned text, including machine-formatted timestamp strings. The time zone of Collection time is not specified.

Missing brand, platform, review-count and listing-status values remain missing rather than being inferred. A blank preview does not assert that the corresponding source value is an empty string. The collection should not be treated as a complete Tmall catalog, a stock snapshot, or a verified offer for a particular order.

What the results look like

Each row represents one Tmall search-result listing. Quoted Price and Sales count values are text, not converted numbers.

SPU IDProduct titlePriceSales countShop name
627049150327闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air"48.39""10万+"闪魔旗舰店
654826062393倍思新无界膜适用苹果iPhone18钢化膜AR抗反射17ProMax保护膜16Pro无尘仓15手机贴膜14全屏13覆盖12防指纹11"91.96""10万+"baseus倍思旗舰店

Additional columns include Image URL, Source page, List position and Collection time.

Use cases

  • Compare search assortment: group Product title by recurring product or accessory terms, then use SPU ID and Shop name to separate distinct listings behind the same keyword.
  • Review displayed pricing: compare Price and Sales count for listings with similar Product title wording, keeping the original text before drawing conclusions about competitiveness.
  • Prepare a 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.

Anwendungsbereich & Grenzen

One Tmall search keyword per task with an expected result count from 1 to 2000; results are collected in source pages of about 10 products and may return fewer or more than requested; fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness; coverage is limited to public Tmall search listings.

  • Geeignet für
  • When you need Tmall search-result products for a brand, product, or category keyword.
  • When you need a structured list that connects each matched listing with its shop, price, rank, and public sales signals.
  • Nicht verwenden für
  • When you need a full product page, variants, reviews, or price history — this App only returns search-result listing information.
  • When you need a strictly capped result count or an immediate single-record lookup.

Fehlerbehandlung

Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.

  1. 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
  2. 2If no matching records are returned, try a shorter or broader search phrase and resubmit.
  3. 3Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  4. 4Retry later after rate limiting, temporary service unavailability, or a timeout.
  5. 5If authentication fails, verify the API Key configured for the execution environment.

Eingabe

Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.

  • Search keywordkeywordErforderlichstring
    Enter one Tmall product search keyword, from 1 to 512 characters.
    Beispieliphone 18 pro max
  • Expected product counttarget_countErforderlichstring
    Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; source pages of about 10 products can return fewer or more listings, and returned listings are billed in batches of 10.
    Beispiel25
  • Collection sort ordersortErforderlichstring(enum)
    Choose how products are ordered during collection. Default is the Tmall default ranking. Delivered results remain in ascending collection-time order.
    Zulässige WerteDefault0Sales2Price: low to high51Price: high to low52Standard0Beispiel0
  • Starting collection pagestartPageOptionalstring
    Enter a positive integer to start collection from that page; if omitted, the upstream service decides the starting page, so explicit entry is recommended. This parameter does not change the expected product count.

Ausgabe

Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.

  • SPU IDspu_idstring
    Tmall product identifier used to distinguish listings.
    Beispiel627049150327
  • Business IDbiz_idstring
    Search keyword retained on the listing; not a unique product identifier.
    Beispieliphone 18 pro max
  • Product titleproduct_titlestring
    Product title as collected, without translation.
    Beispiel闪魔适用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.
    Beispiel48.39

Beispieldaten

Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.

output.example
{
  "spu_id": "627049150327",
  "biz_id": "iphone 18 pro max",
  "product_title": "闪魔适用iPhone17钢化膜苹果18promax手机膜13/15防摔16pro新款duo折叠14全屏X/XR保护11屏幕12pm官ip贴膜Air",
  "price": "48.39",
  "sale_count": "10万+",
  "rate_count": "<rate_count>",
  "brand_name": "<brand_name>",
  "image_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/793375733/O1CN01VFo3XC93RRC2vH2e_!!4611686018427384821-0-item_pic.jpg",
  "shop_id": "793375733",
  "shop_name": "闪魔旗舰店",
  "keyword": "iphone 18 pro max",
  "list_index": "0",
  "now_page": "1",
  "platform": "<platform>",
  "status": "<status>",
  "crawl_time": "2026-10-13T16:47:55",
  "task_item": "iphone 18 pro max",
  "task_no_data": false
}

Integration

Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.

Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.

Client-Konfiguration

Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.

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

Lassen Sie die KI die Einrichtung übernehmen

Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Der Prompt weist die KI an, Ihren API Key bei Ihnen zu erfragen, damit Zugangsdaten nie im Chatverlauf oder in geteilten Konfigurationen landen.)

detail.access.mcp.composeHint

Preise

Task submission

Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.

0,0001 $/ Lauf
10 returned records

Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 10 Datensätze; jede angefangene Einheit wird auf 10 Datensätze aufgerundet.

0,02 $/ 10 Datensätze

Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.

Credits ansehen

Jetzt ausprobieren

Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.

Beispiel
Parameter werden vor dem Absenden gegen input.schema validiert
Ab 0,02 $ / 10 Datensätze