Tmall Shop Product List
Give one Tmall shop ID and an expected product count to collect that shop’s listed products with titles, prices, sales signals, and images.
Original · en-USVolver a la traducción
Descripción general
A Tmall shop page is a useful window into what a merchant currently offers, but the listings are hard to keep as a comparable dataset: titles, prices, images, and sales signals sit together on the page and shift as the assortment changes. This app turns one shop ID into a structured product-level catalog so merchandising, sourcing, and research teams can review that shop’s listed mix without copying rows by hand.
Unlike opening a product you already know, a shop list shows the assortment as it appears in the store itself. Keeping product identity, listing commercial signals, 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 Tmall shop. Product IDs are de-duplicated within the returned dataset. Source item and Business 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. Sales count is displayed text and may include abbreviations or a plus sign, so it should not be treated as an audited transaction total. Collection time has no timezone. Created timestamp is a raw string and may be JSON-encoded milliseconds. A No-data marker distinguishes a shop item 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 Tmall shop product listing associated with the submitted shop, or a no-data marker for that shop.
| Product title | Product ID | Price | Sales count | Shop name | Shop ID |
|---|---|---|---|---|---|
| 十二烷基苯磺酸 烷基苯磺酸 直链烷基苯磺酸 磺酸 500g/瓶 | 12230885327 | 16 | 9000+ | 优索样品 杨静店 | 35318526 |
| 烷基糖苷,烷基多糖苷,APG0810 APG0814 APG1214 APG10 APG06 | 14370874962 | 12.5 | 7000+ | 优索样品 杨静店 | 35318526 |
Product image, Seller ID, Shop URL, Collection time, and No-data marker are also available when supplied with the record. Product titles and shop names 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 sales-signal review, look at Sales count alongside Product title to find listings with stronger on-page demand, without treating the text as an audited sales total.
- For catalog monitoring, compare Product ID and Shop ID across later collections to see which products reappear or drop out of the shop list.
Alcance y límites
One Tmall shop ID per task with an expected product count from 1 to 2,000; the count is a collection target, not a hard result cap. Retrieval is protected at 1,000 pages of up to 1,000 records each. Coverage is limited to public Tmall shop listings.
- Adecuada para
- When you need a product-level catalog snapshot for one Tmall shop.
- When you want to compare listed titles, displayed prices, and public sales signals within a shop.
- No usar para
- When you need product-detail specifications or customer reviews rather than shop-listing data.
- When you need an immediate single-record lookup rather than a background collection task.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1If no products are returned, check the shop ID and resubmit.
- 2Keep completed records after a partial success; resubmit the same shop after a failed or expired task.
- 3Retry later after rate limiting, temporary unavailability, or a timeout.
- 4Results may exceed the requested target count; the count is a collection target, not a strict output limit.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- Tmall shop ID
shop_idObligatoriostringThe ID of the Tmall shop whose product listings you want to collect. Enter one shop ID per task, from 1 to 512 characters.Ejemplo35318526 - Expected product count
crawl_countObligatoriointegerExpected number of products to collect, from 1 to 2,000. This is a collection target, not a hard result cap, so the actual count may be higher. Incomplete groups of 20 returned records are still billed as 20 records.Rango1–2000Ejemplo25 - Collection sort order
sort_orderObligatoriostring(enum)Choose how products are collected: overall, by sales, or newest. Returned rows are still ordered by collection time.Valores permitidosOverall1By sales2Newest4Ejemplo1
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- Business ID
biz_idstringBusiness grouping identifier returned with the listing; empty when none is returned.Ejemplo35318526 - Brand name
brand_namestringBrand name shown on the product listing; empty when none is returned. - Collect timestamp
collect_timestringCollect time as a timestamp string; empty when none is returned. - Collection time
crawl_timestringCollection time for the listing; the source does not specify a timezone.Ejemplo2026-10-13T16:00:32
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"biz_id": "35318526",
"brand_name": "<brand_name>",
"collect_time": "<collect_time>",
"crawl_time": "2026-10-13T16:00:32",
"created_at": "{\"$numberLong\":\"1791878432670\"}",
"data_index": 0,
"date_payload": "<date_payload>",
"image_url": "https://img.alicdn.com/imgextra/i1/42083946/O1CN01UBjaXU1f1K1DjfGEC_!!42083946.jpg",
"now_page": "<now_page>",
"price": "16",
"product_title": "十二烷基苯磺酸 烷基苯磺酸 直链烷基苯磺酸 磺酸 500g/瓶",
"rate_count": "<rate_count>",
"root_url": "https://shop35318526.taobao.com",
"sale_count": "9000+",
"seller_id": "42083946",
"shop_id": "35318526",
"shop_name": "优索样品 杨静店",
"sort_value": "<sort_value>",
"spu_id": "12230885327",
"status": "<status>",
"source_item": "35318526",
"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": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/tmall-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. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)
detail.access.mcp.composeHint
Precios
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
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.
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éditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.