logo
JP

Taobao Keyword Search

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

原文 · en-US訳文に戻す

データ収集E-commerce & RetailTaobaoProducts
開発者
super_ig
料金
$0.02 / 10 件から
最終更新
2026-10-19

概要

Keyword searches on Taobao 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 Taobao 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 Taobao 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 Taobao catalog, a stock snapshot, or a verified offer for a particular order.

What the results look like

Each row represents one Taobao 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.

適用範囲と境界

One Taobao 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 Taobao search listings.

  • 適している用途
  • When you need Taobao 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.
  • 適さない用途
  • 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.

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  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.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • Search keywordkeyword必須string
    Enter one Taobao product search keyword, from 1 to 512 characters.
    例iphone 18 pro max
  • Expected product counttarget_count必須string
    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.
    例25
  • Collection sort ordersort必須string(enum)
    Choose how products are ordered during collection. Default is the Taobao default ranking. Delivered results remain in ascending collection-time order.
    選択可能な値Default0Sales2Price: low to high51Price: high to low52デフォルト0例0
  • Starting collection pagestartPage任意string
    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.

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

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

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

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
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/taobao-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

Task submission

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回
10 returned records

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。

$0.02/ 10 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.02 / 10 件から