logo
ES

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.

Original · en-USVolver a la traducción

Desarrollador
Precios
Desde 0,04 US$ / 20 registros
Última actualización
2026-10-21

Descripción general

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.

Alcance y límites

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.

  • Adecuada para
  • 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.
  • No usar para
  • 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.

Gestión de fallos

Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.

  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.

Entrada

Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.

  • 1688 shop IDshop_idObligatoriostring
    Enter one 1688 shop ID whose product listings you want to collect, from 1 to 512 characters.
    Ejemplob2b-28504255504b611
  • Expected product counttarget_countObligatoriostring
    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.
    Ejemplo25

Salida

Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.

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

Datos de ejemplo

Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.

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
}

Integración

Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino. Esta App se ejecuta de forma asíncrona y se puede cancelar a mitad de camino: Tras la cancelación, la ejecución se detiene. Los registros ya entregados se conservan y se facturan.

Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.

Configuración del cliente

Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.

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>" }
    }
  }
}

Deja que la IA lo configure por ti

¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (De forma predeterminada te guía para iniciar sesión y nunca te pide que envíes tu API Key en el chat.)

detail.access.mcp.composeHint

Precios

Per submitted shop task

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución
20 returned records

Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 20 registros; cualquier unidad parcial se redondea a 20 registros.

0,04 US$/ 20 registros

Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.

Ver créditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Desde 0,04 US$ / 20 registros