logo
FR

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.

Source · en-USRevenir à la traduction

Développeur
Tarifs
À partir de 0,04 $US / 20 enregistrements
Dernière mise à jour
2026-10-21

Aperçu

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.

Périmètre et limites

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.

  • Adapté pour
  • 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.
  • À ne pas utiliser pour
  • 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.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  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.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

  • 1688 shop IDshop_idRequisstring
    Enter one 1688 shop ID whose product listings you want to collect, from 1 to 512 characters.
    Exempleb2b-28504255504b611
  • Expected product counttarget_countRequisstring
    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.
    Exemple25

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

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

Exemple de données

Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.

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
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

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

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)

detail.access.mcp.composeHint

Tarifs

Per submitted shop task

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution
20 returned records

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 20 enregistrements ; toute unité incomplète est arrondie à 20 enregistrements.

0,04 $US/ 20 enregistrements

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
À partir de 0,04 $US / 20 enregistrements