Get Product List

Query product list with filtering and pagination support.

Basic Information

Property	Value
Method	POST
Path	/seller/product
Authentication	Bearer Token
Content-Type	application/json

Request Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer <accessToken>

Request Body Parameters

Parameter	Type	Required	Description
pageIndex	integer	No	Page number, default is 1. Range: 1–100
pageSize	integer	No	Items per page. Range: 1–100
categoryId3	integer	No	Platform category ID
productSpuNum	string	No	Product number
brandIds	array	No	Brand ID list
title	string	No	Product title (fuzzy match)
minPrice	number	No	Minimum price
maxPrice	number	No	Maximum price
productSpuStatus	integer	No	Product status: 0 Draft, 1 On sale, 2 Off shelf, 4 Under review, 5 Exception
createTimeStart	string	No	Creation time start (ISO 8601)
createTimeEnd	string	No	Creation time end (ISO 8601)
updateTimeStart	string	No	Update time start (ISO 8601)
updateTimeEnd	string	No	Update time end (ISO 8601)

Request Example

POST /merchant-api/seller/product HTTP/1.1
Host: paas-gateway.imetastore.io
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
  "pageIndex": 1,
  "pageSize": 20,
  "productSpuStatus": 1
}

Response Parameters

Parameter	Type	Description
data.pageIndex	integer	Current page
data.pageSize	integer	Page size
data.totalCount	integer	Total count
data.pageCount	integer	Total pages
data.list	array	Product list
data.list[].id	integer	Product SPU ID
data.list[].title	string	Product title
data.list[].productSpuNum	string	Product number
data.list[].brandId	integer	Brand ID
data.list[].brandName	string	Brand name
data.list[].categoryId3	integer	Category ID
data.list[].categoryName3	string	Category name
data.list[].productSpuStatus	integer	Product status
data.list[].publishDate	string	Publish date
data.list[].updateTime	string	Update time
data.list[].deliveryType	integer	Delivery type
data.list[].isConsignment	boolean	Is consignment product
data.list[].description	string	Product description
data.list[].isStandard	boolean	Is standard product
data.list[].standardId	string	Standard ID
data.list[].spuItemUrl	string	Product detail link
data.list[].spuListUrl	string	Product list link
data.list[].offShelfReason	string	Off-shelf reason
data.list[].offShelfTime	string	Off-shelf time
data.list[].productSpuImages	array	Product images
data.list[].productSpuImages[].imageUrl	string	Image URL
data.list[].productSpuCategoryAttrs	array	Category attributes
data.list[].productSpuCategoryAttrs[].categoryAttrName	string	Attribute name
data.list[].productSpuCategoryAttrs[].categoryAttrValueName	string	Attribute value
data.list[].productSkus	array	SKU list
data.list[].productSkus[].id	integer	SKU ID
data.list[].productSkus[].title	string	SKU title
data.list[].productSkus[].price	number	SKU price
data.list[].productSkus[].currencyCode	string	Currency code
data.list[].productSkus[].currencySymbol	string	Currency symbol
data.list[].productSkus[].stock	integer	Available stock
data.list[].productSkus[].alertStock	integer	Stock alert threshold
data.list[].productSkus[].minLimit	integer	Minimum purchase limit
data.list[].productSkus[].maxLimit	integer	Maximum purchase limit
data.list[].productSkus[].deliveryTime	integer	Delivery time
data.list[].productSkus[].deliveryTimeUnit	integer	Delivery time unit (1: Day, 2: Hour, 3: Minute)
data.list[].productSkus[].productSkuAttrMap	object	SKU attribute key-value pairs
data.list[].productSkus[].sort	string	Sort value
data.list[].productSkus[].updateTime	string	Update time

Success Response

{
  "code": "0000",
  "msg": "Success",
  "time": "2025-12-17T13:44:16.000Z",
  "data": {
    "pageIndex": 1,
    "pageSize": 20,
    "totalCount": 56,
    "pageCount": 3,
    "list": [
      {
        "id": 2001591587541073922,
        "title": "Premium Game Currency Pack",
        "productSpuNum": "SPU-20251201-001",
        "brandId": 100,
        "brandName": "GameBrand",
        "categoryId3": 500,
        "categoryName3": "Game Currency",
        "productSpuStatus": 1,
        "publishDate": "2025-12-01T10:00:00.000Z",
        "updateTime": "2025-12-10T08:30:00.000Z",
        "deliveryType": 0,
        "isConsignment": false,
        "isStandard": true,
        "standardId": "STD-001",
        "description": "Premium in-game currency pack",
        "spuItemUrl": "https://www.igv.com/items/detail/2001591587541073922",
        "spuListUrl": "https://www.igv.com/items/list/2001591587541073922",
        "productSpuImages": [
          { "imageUrl": "https://example.com/product.png" }
        ],
        "productSpuCategoryAttrs": [
          {
            "categoryAttrName": "Platform",
            "categoryAttrValueName": "PC"
          }
        ],
        "productSkus": [
          {
            "id": 3001591587541073001,
            "title": "1000 Gold Coins",
            "price": 9.99,
            "currencyCode": "USD",
            "currencySymbol": "$",
            "stock": 500,
            "alertStock": 50,
            "minLimit": 1,
            "maxLimit": 10,
            "deliveryTime": 24,
            "deliveryTimeUnit": 2,
            "productSkuAttrMap": { "Denomination": "1000" },
            "sort": "1",
            "updateTime": "2025-12-10T08:30:00.000Z"
          }
        ]
      }
    ]
  }
}