返回 Skill 列表
extension
分类: 数据与分析需要 API Key

Taobao and Tmall Shop Product List API

通过JustOneAPI调用3个get‑shop‑item‑list版本获取淘宝和天猫店铺商品列表,需要shopId和userId。

person作者: justoneapihubclawhub

Taobao and Tmall Shop Product List

Use this focused JustOneAPI skill for shop Product List in Taobao and Tmall. It targets 3 versioned paths under /api/taobao/get-shop-item-list. Required non-token inputs are shopId and userId. OpenAPI describes it as: Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking.

Endpoint Scope

  • Platform key: taobao
  • Endpoint key: get-shop-item-list
  • Platform family: Taobao and Tmall
  • Skill slug: justoneapi-taobao-get-shop-item-list

| Operation | Version | Method | Path | OpenAPI summary | | --- | --- | --- | --- | --- | | getTaobaoShopItemListV1 | v1 | GET | /api/taobao/get-shop-item-list/v1 | Shop Product List | | getShopItemListV2 | v2 | GET | /api/taobao/get-shop-item-list/v2 | Shop Product List | | getShopItemListV3 | v3 | GET | /api/taobao/get-shop-item-list/v3 | Shop Product List |

Inputs

| Parameter | In | Required by | Optional by | Type | Notes | | --- | --- | --- | --- | --- | --- | | page | query | n/a | all | integer | Page number for pagination | | shopId | query | getShopItemListV2, getShopItemListV3 | n/a | string | Unique shop identifier on Taobao/Tmall (shop ID) | | sort | query | n/a | all | string | Sort order for the result set. Available Values: - _sale: Sales - _default: Default | | sort enum | values | n/a | n/a | n/a | _bid, _default, _sale, bid, coefp, hotsell, oldstarts | | userId | query | all | n/a | string | Shop identifier. Also known as Seller ID or User ID (they refer to the same value) |

Request body: none documented; send parameters through path or query arguments.

Version Choice

This skill groups 3 endpoint versions because their paths share get-shop-item-list after removing the trailing version segment. Choose the version the user requested; if no version was requested, pick the operation whose required inputs match the data the user has.

  • getTaobaoShopItemListV1 (v1): required inputs userId.
  • getShopItemListV2 (v2): required inputs userId and shopId.
  • getShopItemListV3 (v3): required inputs userId and shopId.

Run This Endpoint

Supported operation IDs in this skill: getTaobaoShopItemListV1, getShopItemListV2, getShopItemListV3.

node {baseDir}/bin/run.mjs --operation "getTaobaoShopItemListV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"userId":"<userId>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.

Environment

  • Required: JUST_ONE_API_TOKEN
  • Pass the token with --token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Focus

  • State the operation ID and endpoint path used, for example getTaobaoShopItemListV1 on /api/taobao/get-shop-item-list/v1.
  • Echo the required lookup scope (shopId and userId) before summarizing results.
  • Prioritize fields that support this endpoint purpose: Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking.
  • Return raw JSON only after the short, endpoint-specific summary.
  • If the backend errors, include the backend payload and the exact operation ID.