跳转到内容
Cheeli 文档
返回官网

分销增强商品列表接口

获取1688分销商品，可以类目、关键词、是否支持一件代发等多维度查询商品。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/1688/fenxiao/jxhy/search

基础参数

参数名类型必须示例值说明
appidStringtrue32432143214214合作伙伴AppId
timestampStringtrue1633618722当前时间戳
seller_nickString可选b2b-16249611221688账号
signStringtrue999de41d862efaa6f1084ead3b3ba480如何计算生成见示例代码

业务参数

名称类型是否必须描述示例值
pageNumInteger否当前页码1
pageSizeInteger否分页大小（默认为20）10
keywordString否关键词“连衣裙”
categoryIdLong否类目Id，1，2，3级均可，填几级类目就限定到第几级80
priceStartString否价格区间开始（大市场价格，元）“1”
priceEndString否价格区间结束（大市场价格，元）“10”
filtersString否过滤条件，多个可以使用英文逗号隔开，如下：
isOnePsale：一件代发

isOnePsaleFreePost：一件代发包邮

noReason7DReturn：7天无理由退货
”isOnePsale”

二、请求示例代码

Java

@Test
    public void AlibabaFenxiaoJXHYRequest() throws Exception {
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick",  Config.AlibabaFenXiaoSellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("filters", "isOnePsale");
        data.put("categoryId", "10166");
        data.put("keyword", "衬衫");
        data.put("pageNum", "1");
        data.put("pageSize", "20");
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        String response = doHttpRequest(Config.AlibabaFenxiaoJXHYRequestUrl, data);
    }

三、返回结果

3.1成功情况

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "code": "0",
    "result": [
      {
        "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01PcPUqt2Lyaja6dt7l_!!2213051949761-0-cib.jpg",
        "itemId": 667701506689,
        "maxPrice": 1850,
        "minPrice": 1850,
        "salesCnt90d": 215,
        "serviceList": [
          {
            "code": "ssbxsfh",
            "name": "48小时发货"
          },
          {
            "code": "qtbh",
            "name": "7天包换"
          },
          {
            "code": "qtwlybt",
            "name": "7天无理由包退"
          },
          {
            "code": "czbz",
            "name": "材质保障（限地区）"
          }
        ],
        "title": "春季韩版修身白衬衫女长袖学生职业装工装小清新打底衬衣女工作服",
        "skuCnt": 126
      },
      {
        "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01tqv0BY2CtFckiUxG6_!!4092448531-0-cib.jpg",
        "itemId": 690717559861,
        "maxPrice": 6000,
        "minPrice": 6000,
        "salesCnt90d": 39,
        "serviceList": [
          {
            "code": "ssbxsfh",
            "name": "48小时发货"
          },
          {
            "code": "qtbh",
            "name": "7天包换"
          },
          {
            "code": "czbz",
            "name": "材质保障（限地区）"
          }
        ],
        "title": "软糯韩系温柔纯色棉衬衫女2024春秋新款叠穿内搭宽松休闲上衣外套",
        "skuCnt": 4
      },
      {
        "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01bhb32M2EGRY0kHuOH_!!2212169528717-0-cib.jpg",
        "itemId": 863317895852,
        "maxPrice": 3300,
        "minPrice": 3300,
        "serviceList": [
          {
            "code": "ssbxsfh",
            "name": "48小时发货"
          },
          {
            "code": "qtbh",
            "name": "7天包换"
          },
          {
            "code": "qtwlybt",
            "name": "7天无理由包退"
          },
          {
            "code": "shbp",
            "name": "少货必赔"
          }
        ],
        "title": "2025欧美跨境女装亚马逊独立站春夏新款刺绣圆领泡泡短袖衬衫上衣",
        "skuCnt": 25
      },
      {
        "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01ky5shO1e072lyZeTd_!!1741453808.jpg",
        "itemId": 895110619077,
        "maxPrice": 1700,
        "minPrice": 1700,
        "serviceList": [
          {
            "code": "ssbxsfh",
            "name": "48小时发货"
          },
          {
            "code": "qtbh",
            "name": "7天包换"
          },
          {
            "code": "qtwlybt",
            "name": "7天无理由包退"
          },
          {
            "code": "czbz",
            "name": "材质保障（限地区）"
          },
          {
            "code": "psbj",
            "name": "破损包赔"
          },
          {
            "code": "shbp",
            "name": "少货必赔"
          },
          {
            "code": "hdbp",
            "name": "坏单包赔"
          }
        ],
        "title": "春秋格子衬衫女宽松慵懒风女装上衣2025早秋新款衬衣复古格纹外套",
        "skuCnt": 6
      }
    ],
    "pageInfo": {
      "currentPage": 1,
      "totalRecords": 2000,
      "pageSize": 20
    }
  },
  "trace_id": ""
}

三、返回字段说明

名称类型描述示例值
imgUrlString图片链接http://ali.cdn.ss/adfs/23434565.png
itemIdLong商品id323222
maxPriceLong最大价格（分）5900
minPriceLong最小价格（分）5900
salesCnt90dLong90天销量1100
titleString商品标题帽子防晒帽快干太阳帽儿童亲子遮阳帽
skuCntLongsku数量3
serviceList对象集合
— codeString买家服务保障名称码qtwlybt
— nameString买家服务保障名称
pageInfo分页对象
— currentPageInteger当前页码1
— totalRecordsInteger总的记录数2000
— pageSizeInteger分页大小20

说明： code为0表示成功，非0为失败，message会包含失败原因。 业务上是否成功，以data内的success为准 。