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

国内分销词搜

国内分销词搜选品,对于搜索出来的商品，可以通过调用获取商品详情获取商品详情信息。

一、请求参数

请求URL:

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

基础参数

参数名类型必须示例值说明
appidStringtrue32432143214214合作伙伴AppId
timestampStringtrue1633618722当前时间戳
seller_nickStringtrueb2b-16249611221688账号
signStringtrue999de41d862efaa6f1084ead3b3ba480如何计算生成见示例代码
request_dataJsontrue查询条件的业务报文

request业务参数

名称类型是否必须描述示例值
categoryIdsjava.lang.String[]否限定类目ID列表，从类目搜索接口获取[“10166”]
filterjava.lang.String[]否该参数于2025-08-08失效！！，请不要再使用 选品中心小二的严选优质品:454658 线下选品中心陈列品:454466[“454658”, “454466”]
keywordsjava.lang.String否搜索关键词衣服
pageNumjava.lang.Long否当前页码1
pageSizejava.lang.Long否分页页大小，默认20最大5020
priceEndjava.lang.String否价格区间结束（单位 元）1
priceStartjava.lang.String否价格区间开始（单位 元）5
quantityBeginjava.lang.Long否起批量1

request_data的示例报文

{
  "filter" : [ "454466" ],
  "keywords" : "鞋子",
  "pageSize" : 10,
  "pageNum" : 1
}

二、请求示例代码

Java

@Test
    public void AlibabaOceanOpenplatformBizSearchParamOpenKeywordsSearchRequest() 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());
        JSONObject   requestData = new JSONObject();


//        JSONArray filters = new JSONArray();
//        filters.add("454466");
//        requestData.put("filter", filters);
        requestData.put("keywords", "鞋子");
        requestData.put("pageNum", 1);
        requestData.put("pageSize", 10);
        data.put("request_data", requestData.toJSONString());
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        String response = doHttpRequest(Config.One688FenXiaocKeyWordsOfferSearchRequest, data);
    }

三、返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "success": true,
      "code": null,
      "message": null,
      "result": [
        {
          "openOfferId": null,
          "subject": "多层抽屉式收纳柜大容量文胸袜子衣服置物柜卧室床头杂物储物柜子",
          "offerId": 805683431540,
          "loginId": "台州日百供应链",
          "unit": null,
          "quantityBegin": null,
          "offerWeight": null,
          "offerSuttleWeight": null,
          "isJxhy": null,
          "userId": null,
          "companyInfo": {
            "companyName": "台州日百供应链管理有限公司",
            "city": "台州市",
            "province": "浙江",
            "creditLevel": null,
            "isFactory": null,
            "shopRepurchaseRate": null,
            "shopRepurchaseRateLevel": null,
            "url": "https://m.1688.com/winport/b2b-22176143595548a83e.html?__existtitle__=1"
          },
          "offerImage": {
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01XKyLNF2KRmybOQKSm_!!2217614359554-0-cib.jpg"
          },
          "offerPrice": {
            "consignPrice": "63.70",
            "priceUnderLine": "109.0",
            "price": "109.0",
            "quantityPrice": null
          },
          "offerTradeServiceInfo": [],
          "offerHistoryTradeInfo": null,
          "qualityEvaluation": {
            "compositeScore": 4.0,
            "consultationScore": 3.0,
            "disputeScore": 4.0,
            "logisticsScore": 3.0,
            "goodsScore": 3.0,
            "returnScore": 3.0
          }
        }
      ],
      "pageInfo": {
        "totalPage": 50,
        "currentPage": 1,
        "pageSize": 1,
        "totalRecords": 50
      }
    }
  },
  "trace_id": ""
}

为空的情况

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "success": false,
      "code": "SEARCH_ERROR",
      "message": null,
      "result": null,
      "pageInfo": null
    }
  },
  "trace_id": ""
}

说明： code为0表示成功，非0为失败，message会包含失败原因。业务上成功与否，见data中success值，返回字段说明见文档