1688分销增强商品列表接口

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

1.请求参数:

请求URL:

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

基础参数

参数名 类型 必须 示例值 说明
appid String true 32432143214214 合作伙伴AppId
timestamp String true 1633618722 当前时间戳
seller_nick String true b2b-1624961122 1688账号
sign String true 999de41d862efaa6f1084ead3b3ba480 如何计算生成见示例代码

业务参数

名称 类型 是否必须 描述 示例值
pageNum Integer 当前页码 1
pageSize Integer 分页大小(默认为20) 10
keyword String 关键词 “连衣裙”
categoryId Long 类目Id,1,2,3级均可,填几级类目就限定到第几级 80
priceStart String 价格区间开始(大市场价格,元) “1”
priceEnd String 价格区间结束(大市场价格,元) “10”
filters String 过滤条件,多个可以使用英文逗号隔开,如下:
isOnePsale:一件代发

isOnePsaleFreePost:一件代发包邮

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

2. 请求示例代码(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. 返回结果如下:

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": ""
}
3. 返回字段说明
名称 类型 描述 示例值
imgUrl String 图片链接 http://ali.cdn.ss/adfs/23434565.png
itemId Long 商品id 323222
maxPrice Long 最大价格(分) 5900
minPrice Long 最小价格(分) 5900
salesCnt90d Long 90天销量 1100
title String 商品标题 帽子防晒帽快干太阳帽儿童亲子遮阳帽
skuCnt Long sku数量 3
serviceList 对象集合
— code String 买家服务保障名称码 qtwlybt
— name String 买家服务保障名称
pageInfo 分页对象
— currentPage Integer 当前页码 1
— totalRecords Integer 总的记录数 2000
— pageSize Integer 分页大小 20

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

文档更新时间: 2025-08-08 16:57   作者:admin