{
  "openapi": "3.0.0",
  "info": {
    "title": "Taobao and Tmall Product Search API (V1)",
    "version": "1.0.0",
    "description": "Get Taobao and Tmall product Search data, including titles, prices, and images, for product discovery."
  },
  "paths": {
    "/api/taobao/search-item-list/v1": {
      "get": {
        "tags": [
          "Taobao and Tmall"
        ],
        "summary": "Product Search",
        "description": "Get Taobao and Tmall product Search data, including titles, prices, and images, for product discovery.",
        "operationId": "searchItemListV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "Access token for this API service.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "Search keyword.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Sort order for the result set.\n\nAvailable Values:\n- `_sale`: Sales\n- `_bid`: Price: High to Low\n- `bid`: Price: Low to High\n- `_coefp`: General",
            "required": false,
            "schema": {
              "type": "string",
              "default": "_sale",
              "description": "Taobao Search Item List Sort Enum",
              "enum": [
                "_sale",
                "_bid",
                "bid",
                "_coefp"
              ]
            }
          },
          {
            "name": "tmall",
            "in": "query",
            "description": "Whether to filter results to Tmall only.",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "startPrice",
            "in": "query",
            "description": "Minimum price filter (inclusive).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endPrice",
            "in": "query",
            "description": "Maximum price filter (inclusive).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "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": {
                    "code": "SUCCESS",
                    "extraMap": {
                      "MtopCostMillis": 72
                    },
                    "model": {
                      "brandList": [
                        {
                          "brandId": 1116992510,
                          "brandName": "徽味和",
                          "count": 12
                        }
                      ],
                      "costMillis": 71,
                      "extraMap": {
                        "WorldsearchIP": "33.44.173.30",
                        "WorldsearchName": "worldsearch033044173030.center.na620",
                        "EndpointHost": "33.69.77.30",
                        "sp_status": "OK",
                        "Endpoint": "taobao_item",
                        "afterSearchCostMillis": 0
                      },
                      "itemList": [
                        {
                          "cityEn": "",
                          "commentCount": "",
                          "discntPriceYuan": 13.9,
                          "discntRate": 348,
                          "discntType": "活动价",
                          "extraMap": {},
                          "fahuoDsr": "487",
                          "frontStock": 92034,
                          "fuwuDsr": "486",
                          "hasTongkuan": false,
                          "hasXiangsi": false,
                          "itemGradeAvg": 0,
                          "itemId": 638549822878,
                          "itemLoc": "湖南 长沙",
                          "itemName": "皇家小虎手抓饼面饼皮正品旗舰店早餐半成品美食葱油煎饼卷饼商用",
                          "itemNameEn": "",
                          "itemSubName": "猪油起酥 千层酥脆 无需解冻 3分钟营养早餐",
                          "itemSubNameEn": "",
                          "itemType": "b",
                          "miaoshuDsr": "483",
                          "options": 17750295040,
                          "orderPayUV": "1万+",
                          "picUrl": "i2/3578271683/O1CN013v45XU1OIrg7zeMMP_!!4611686018427385795-0-item_pic.jpg",
                          "picUrlFull": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/3578271683/O1CN013v45XU1OIrg7zeMMP_!!461168601842...",
                          "picUrlList": [
                            "i1/3578271683/O1CN01HjLE5T1OIrYaObHf5_!!3578271683.jpg"
                          ],
                          "priceFen": 39900,
                          "priceYuanDouble": 399,
                          "priceZKFen": 1390,
                          "priceZKYuanDouble": 13.9,
                          "prodId": 104492152,
                          "provEn": "",
                          "sellerGoodrat": 10000,
                          "sellerLevel": 18,
                          "sellerLoc": "上海 上海",
                          "serviceList": [],
                          "shopId": 3578271683,
                          "shopName": "皇家小虎旗舰店",
                          "spuId": 8750681503,
                          "tagList": [],
                          "tmcTagList": [
                            "47109"
                          ],
                          "userTag": 18014535948435464,
                          "userType": 1,
                          "vidname": ""
                        }
                      ],
                      "page": {
                        "nextNo": 2,
                        "pageNo": 1,
                        "pageSize": 10,
                        "prevNo": 1,
                        "showBegin": 1,
                        "showEnd": 3,
                        "totalItems": 176338,
                        "totalPages": 17634
                      },
                      "propertyList": [
                        {
                          "flag": "qp_commend",
                          "pid": 122450261,
                          "pname": "省份",
                          "valueList": [
                            {
                              "count": 1381,
                              "flag": "qp_commend",
                              "vid": 52863,
                              "vname": "福建省"
                            }
                          ]
                        }
                      ],
                      "responseStatus": 0,
                      "success": true,
                      "traceList": []
                    }
                  }
                }
              }
            }
          }
        },
        "x-order": "11001900"
      }
    }
  },
  "components": {}
}