国内分销词搜

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

1.请求参数:

请求URL:

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

基础参数

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

request业务参数

名称 类型 是否必须 描述 示例值
categoryIds java.lang.String[] 限定类目ID列表,从类目搜索接口获取 [“10166”]
filter java.lang.String[] 选品中心小二的严选优质品:454658 线下选品中心陈列品:454466 [“454658”, “454466”]
keywords java.lang.String 搜索关键词 衣服
pageNum java.lang.Long 当前页码 1
pageSize java.lang.Long 分页页大小,默认20最大50 20
priceEnd java.lang.String 价格区间结束(单位 元) 1
priceStart java.lang.String 价格区间开始(单位 元) 5
quantityBegin java.lang.Long 起批量 1

request_data的示例报文

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

2. 请求示例代码(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);
    }

3. 返回结果如下:

{
  "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值,返回字段说明见文档

文档更新时间: 2025-07-01 18:03   作者:admin