logo
EN

1688 Shop Product List

Give one 1688 shop ID and an expected product count to collect that shop's listed products with titles, prices, images, and source links.

Developer
Pricing
From $0.04 / 20 records
Last updated
2026-10-21

Overview

A 1688 shop page is a useful window into what a merchant currently offers, but titles, prices, images, and listing links sit together on the page and are hard to keep as a comparable catalog. This app turns one shop ID into a structured product-level list so sourcing and merchandising teams can review that shop's visible assortment without copying rows by hand.

Unlike looking up a product you already know, a shop list shows the assortment as it appears in the store. Keeping product identity, displayed price, image, and shop context in the same row makes it possible to map price bands, watch which items stay listed, or assemble a candidate set from one merchant.

Data notes

Each record is a public product listing from the supplied 1688 shop. SPU IDs are de-duplicated within the returned dataset. Business ID, Shop ID, and Submitted shop ID preserve the shop context and may repeat across many products from the same task. Listings are returned in a stable ascending collection-time order.

Price is the listing amount as a raw string, with no separate currency field and no conversion into another unit. Product titles remain in the original language. A No-data indicator distinguishes a shop that produced no matching products from ordinary listing rows.

The collection covers public listings for the supplied shop only. It does not include other shops, product-detail specifications, comments, or order data.

What a result looks like

Each row is one 1688 shop product listing associated with the submitted shop.

Product titleSPU IDPriceShop IDProduct URL
亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套9904570602209b2b-28504255504b611https://m.1688.com/offer/990457060220.html
MOQ50适用三星Z Flip 6折叠连体透明亚克力套啤保护套上下防摔7967359821637b2b-28504255504b611https://m.1688.com/offer/796735982163.html

Image URL, Business ID, Submitted shop ID, and No-data indicator are also available when supplied with the record. Product titles may remain in the original language.

Use cases

  • For assortment mapping, group rows by Shop ID and compare Product title with Price to see the shop's visible mix and price bands.
  • For sourcing shortlists, keep SPU ID, Product URL, and Image URL together so later reviews can open the same listing.
  • For catalog monitoring, compare SPU ID and Shop ID across later collections to see which products reappear or drop out of the shop list.

Scope and boundaries

One 1688 shop ID per run; the requested collection target is 1–500 products, not a strict result limit. Collection may return fewer or more products. Fetch protection is 25 pages / 500 records; reaching this capacity does not establish completeness.

  • Good for
  • When you need a product-level catalog snapshot for one 1688 shop.
  • When you want to compare listed titles, displayed prices, and source links within a shop.
  • Do not use for
  • When you need product-detail specifications, supplier profiles, or customer reviews rather than shop-listing data.
  • When you need a guaranteed real-time quote 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. 2If no products are returned, check the shop ID; an empty result does not by itself mean that the source explicitly reported no data.
  3. 3Keep completed records after a partial success; resubmit the same shop after a failed or expired task.
  4. 4Reaching the fetch protection capacity also requires a completeness check.

Input

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

  • 1688 shop IDshop_idRequiredstring
    Enter one 1688 shop ID whose product listings you want to collect, from 1 to 512 characters.
    Exampleb2b-28504255504b611
  • Expected product counttarget_countRequiredstring
    Enter a whole number from 1 to 500 as digits only. This is a collection target, not a strict cap; collection can return fewer or more products.
    Example25

Output

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

  • Business IDbizIdstring
    Task business identifier associated with the listing; it may repeat across products from the same shop.
    Exampleb2b-28504255504b611
  • Image URLimageUrlstring
    Product image link as collected.
    Examplehttps://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg
  • Pricepricestring
    Price text as collected; no currency or numeric conversion is applied.
    Example9
  • Product titleproductTitlestring
    Product title as collected, without translation.
    Example亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套

Sample data

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

output.example
{
  "bizId": "b2b-28504255504b611",
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg",
  "price": "9",
  "productTitle": "亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套",
  "productUrl": "https://m.1688.com/offer/990457060220.html",
  "shopId": "b2b-28504255504b611",
  "spuId": "990457060220",
  "task_item": "b2b-28504255504b611",
  "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/alibaba1688-shop-product-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

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. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

detail.access.mcp.composeHint

Pricing

Per submitted shop task

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

$0.0001/ run
20 returned records

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

$0.04/ 20 records

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.04 / 20 records