Taobao and Tmall

Shop Product List

Changed on

Retrieves products from a Taobao shop by seller ID and shop ID, with optional shop-category filtering, keyword search, sorting, and page-based pagination. Use it to browse a shop catalog or find matching products within a shop.

get/api/taobao/get-shop-item-list/v5

Request

Query parameters

tokenstring required

Access token for this API service.

sellerIdstring required

Taobao seller user ID associated with the shop.

shopIdstring required

Taobao shop ID associated with the seller.

catIdstring

Shop category ID from Shop Detail. Omit to include all shop categories.

keywordstring

Keyword to search for products within the shop. Omit to list products without a keyword filter.

sort'comprehensive' | 'sales' | 'new' | 'price-asc' | 'price-desc'

Sort order for shop product list V5

Product sort order.

Available Values:

  • comprehensive: Comprehensive sorting
  • sales: Sort by sales volume
  • new: Sort by new arrivals, newest first
  • price-asc: Price, lowest first
  • price-desc: Price, highest first
pageinteger

Page number, starting from 1.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
dataunknown required
recordTimestring nullable required
requestIdstring
reasonstring

Changes