{
  "openapi": "3.0.0",
  "info": {
    "title": "Taobao and Tmall Shop Product List API (V3)",
    "version": "1.0.0",
    "description": "Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking."
  },
  "paths": {
    "/api/taobao/get-shop-item-list/v3": {
      "get": {
        "tags": [
          "Taobao and Tmall"
        ],
        "summary": "Shop Product List",
        "description": "Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking.",
        "operationId": "getShopItemListV3",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "Access token for this API service.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "userId",
            "in": "query",
            "description": "Shop identifier. Also known as Seller ID or User ID (they refer to the same value).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "shopId",
            "in": "query",
            "description": "Unique shop identifier on Taobao/Tmall (shop ID).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort order for the result set.\n\nAvailable Values:\n- `coefp`: Comprehensive sorting\n- `hotsell`: Hot selling / Sales volume\n- `oldstarts`: New arrivals / Old starts\n- `bid`: Price: Low to High\n- `_bid`: Price: High to Low",
            "required": false,
            "schema": {
              "type": "string",
              "default": "coefp",
              "description": "Sort types for product list (V5.0)",
              "enum": [
                "coefp",
                "hotsell",
                "oldstarts",
                "bid",
                "_bid"
              ]
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "result": {
                      "currentSort": "coefp",
                      "totalResults": 2305,
                      "pageSize": 10,
                      "shopTitle": "优衣库官方旗舰店",
                      "shopId": 57303596,
                      "currentPage": 1,
                      "itemsArray": [
                        {
                          "isChannelBybt": false,
                          "umpPromoPrice": {
                            "adsPoints": null,
                            "originalPrice": "999.00",
                            "channelKey": null,
                            "price": "999.00",
                            "display": "优惠后",
                            "newBenefit": null,
                            "skuId": 6084192078392
                          },
                          "isJoinBrand": true,
                          "discntType": "活动价",
                          "spatialThumbPic": null,
                          "itemTitle": "优衣库莫雷加德同款男装女装高级保暖羽绒大衣外套冰雪羽绒481200",
                          "spZkType": "活动价",
                          "recommendDesc": "",
                          "liveData": null,
                          "atmosphereList": [],
                          "imageUrlList": "",
                          "isPresell": false,
                          "itemImages": [
                            "i1/196993935/O1CN01lS3CDD1ewHdP4CQr7_!!4611686018427380623-0-item_pic.jpg"
                          ],
                          "isJHS": true,
                          "showTitleStructure": "{\"interest\":\"优衣库男装女装高级保暖羽绒大衣\"}",
                          "icQuantity": "200",
                          "spatialVideoDimension": "",
                          "spUvsum": "500+",
                          "pictUrlWap": null,
                          "spatialVideoUrl": "",
                          "auctionExt": "femaleclothe_upright_image_structure:1 upright_imageurl:i1/196993935/O1CN01jxulex1ewHdOqlbZw_!!46116...",
                          "isJoinSameItem": false,
                          "categoryp": "50011167 30 0",
                          "isPostFree": false,
                          "mainPicVideoDetail": [],
                          "spUvsumSuc": "500+",
                          "whiteBgImage": "i1/196993935/O1CN01OAf7co1ewHcQkUs10_!!4611686018427380623-2-item_pic.png",
                          "auctionTag": "587 907 1163 1478 1483 2049 2059 2123 3394 3851 3974 4166 4491 4550 4555 6401 6603 7046 7174 9478 11...",
                          "auction_id": "970865704078",
                          "pictUrl": "i1/196993935/O1CN01lS3CDD1ewHdP4CQr7_!!4611686018427380623-0-item_pic.jpg",
                          "discntPrice": "999.00",
                          "preSellPrice": null,
                          "userId": "196993935",
                          "tmcTags": "100047031 47109 47302 47048 100047260 100047101 47213 100047302 100047109 47031 100047213 47260 4710...",
                          "icSubTitle": "初上市价格1299元",
                          "videoPic": "",
                          "promoMBasePrice": "999.00",
                          "showTitle": "优衣库男装女装高级保暖羽绒大衣",
                          "auctionStatus": 1,
                          "feedbackCount": "1000+",
                          "tradeData": [
                            {
                              "feature": {},
                              "sceneCode": "REAL_SALES_365",
                              "text": "已售1万+",
                              "subjectId": 970865704078
                            }
                          ],
                          "isMall": "1",
                          "category": "50011167",
                          "h5ResistDetail": false
                        }
                      ]
                    },
                    "logs": []
                  }
                }
              }
            }
          }
        },
        "x-order": "11001800"
      }
    }
  },
  "components": {}
}