Durchsuchen Sie 1688 nach Stichwörtern und erfassen Sie Produktangebote mit Preisen, Verkaufszahlen und Originalverweisen.
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-USZur Übersetzung
Übersicht
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 title | SPU ID | Price | Shop ID | Product URL |
|---|---|---|---|---|
| 亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套 | 990457060220 | 9 | b2b-28504255504b611 | https://m.1688.com/offer/990457060220.html |
| MOQ50适用三星Z Flip 6折叠连体透明亚克力套啤保护套上下防摔 | 796735982163 | 7 | b2b-28504255504b611 | https://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.
Anwendungsbereich & Grenzen
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.
- Geeignet für
- 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.
- Nicht verwenden für
- 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.
Fehlerbehandlung
Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.
- 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
- 2If no products are returned, check the shop ID; an empty result does not by itself mean that the source explicitly reported no data.
- 3Keep completed records after a partial success; resubmit the same shop after a failed or expired task.
- 4Reaching the fetch protection capacity also requires a completeness check.
Eingabe
Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.
- 1688 shop ID
shop_idErforderlichstringEnter one 1688 shop ID whose product listings you want to collect, from 1 to 512 characters.Beispielb2b-28504255504b611 - Expected product count
target_countErforderlichstringEnter 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.Beispiel25
Ausgabe
Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.
- Business ID
bizIdstringTask business identifier associated with the listing; it may repeat across products from the same shop.Beispielb2b-28504255504b611 - Image URL
imageUrlstringProduct image link as collected.Beispielhttps://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg - Price
pricestringPrice text as collected; no currency or numeric conversion is applied.Beispiel9 - Product title
productTitlestringProduct title as collected, without translation.Beispiel亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套
Beispieldaten
Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.
{
"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
Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.
Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.
Client-Konfiguration
Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/alibaba1688-shop-product-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Lassen Sie die KI die Einrichtung übernehmen
Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Standardmäßig führt er Sie durch die Anmeldung und fordert Sie nie auf, Ihren API Key im Chat zu senden.)
detail.access.mcp.composeHint
Preise
Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.
Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 20 Datensätze; jede angefangene Einheit wird auf 20 Datensätze aufgerundet.
Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.
Credits ansehenJetzt ausprobieren
Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.