1688 Keyword Search

概要

Keyword searches on 1688 can reveal several product styles, materials and listing variants behind the same buying need. Bringing those listings together makes it easier to review the available assortment without losing the original product titles and links needed for a closer look.

This collection pairs listing details with the search context that produced them. It provides a starting point for sourcing research and comparison, rather than replacing product-page checks or a conversation with a supplier about an eventual purchase.

Data notes

The data describes product listings collected from 1688 keyword searches. 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.

Product titles, listing status, price text and sales count text retain their source values. Price and Promotional price are not converted into another currency, and no assumptions are made about taxes, delivery charges or purchasing conditions. The sales measurement period and the time zone of Collection time are not specified.

Missing area, seller and shop details 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 supplier directory or a quotation for a particular order.

What the results look like

Each row represents a product listing. The examples retain the original titles; quoted Price and Sales count values are text, not converted numbers.

Product ID	Product title	Price	Sales count	Keyword
1065208644543	Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16	"85"	"0"	iphone 18 pro max
816387948239	适用苹果18promax手机壳插卡包翻盖iPhone17防摔16商务15真皮套14	"158"	"0"	iphone 18 pro max

Additional columns include Product URL, Image URL, Promotional price and Collection time.

Use cases

Compare an assortment: group Product title by recurring material or design terms, then use Product ID and Product URL to inspect the distinct listings behind each group.
Review displayed pricing: compare Price with Promotional price for listings with similar Product title wording, keeping the original price text and checking purchase conditions before drawing conclusions.
Prepare a sourcing shortlist: combine Keyword, Product title and Image URL to identify relevant candidates, and retain Collection time so later reviews can distinguish the collection snapshots.

適用範囲と境界

One keyword per run; the requested collection target is 1–2,000 products, not a strict result limit. Whole-page collection may return fewer or more products. Fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness.

適している用途
Find 1688 listings for keyword-based product sourcing and comparison.

適さない用途
Do not use this for guaranteed real-time quotes, complete supplier profiles or a strictly capped result count.

失敗時の処理

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

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.

入力

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

Search keywordkeyword必須string
Enter one 1688 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; whole-page collection can return fewer or more products.
例25
Collection sort ordersort任意string(enum)
Choose how products are ordered during collection; the default is relevance. Delivered results remain in ascending collection-time order.
選択可能な値RelevancebidPrice: high to lowbid2Price: low to high_bid2Sales: high to lowsaleデフォルトbid
Start collection pagestartPage任意string
Specify the page number where collection starts. Enter a positive integer; when omitted, collection starts at page 1 by default. This does not change the expected product count.
デフォルト1例2

出力

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

Product IDproductIdstring
1688 product identifier.
例1065208644543
Product titleproductTitlestring
Product title as collected, without translation.
例Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16
Product URLproductUrlstring
Link to the 1688 product listing.
例https://detail.1688.com/offer/1065208644543.html
Image URLimageUrlstring
Product image link as collected.
例https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg

サンプルデータ

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

output.example

{
  "productId": "1065208644543",
  "productTitle": "Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16",
  "productUrl": "https://detail.1688.com/offer/1065208644543.html",
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg",
  "price": "85",
  "promotionPrice": "85",
  "saleCount": "0",
  "keyword": "iphone 18 pro max",
  "sourceItem": "iphone 18 pro max",
  "status": "有效",
  "tagPercent": "25%",
  "area": "<area>",
  "pageNum": "<pageNum>",
  "sellerName": "<sellerName>",
  "shopId": "<shopId>",
  "shopName": "<shopName>",
  "crawlTime": "2026-10-10T18:07:09",
  "createdAt": "1791626829270",
  "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/alibaba1688-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/ 回

Returned products

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

$0.01/ 20 件

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

Credits を確認

今すぐ試す

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

サンプル

パラメータは送信前に input.schema で検証されます

Search keywordkeyword*Enter one 1688 product search keyword, from 1 to 512 characters.

Expected product counttarget_count*Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; whole-page collection can return fewer or more products.

Collection sort ordersort（任意）Choose how products are ordered during collection; the default is relevance. Delivered results remain in ascending collection-time order.

Start collection pagestartPage（任意）Specify the page number where collection starts. Enter a positive integer; when omitted, collection starts at page 1 by default. This does not change the expected product count.

概要