图搜内贸代发商品

图搜内贸代发商品,根据提供的图片,在1688查找相似商品。对于搜索出来的商品,可以通过调用获取商品详情获取商品详情信息。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/1688/fenxiao/image/similar/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业务参数

名称 类型 是否必须 描述 示例值
imgUrl String 图片地址 https://www.gcdn01.com/xsf.jpg
imageKeywords String 图搜关键词utf8 “连衣裙”,对于图片的辅助说明,系统以识别到图片内容为主。
filter String[] 图搜过滤项 参考接口文档

filter的过滤条件

其中filter用于商品过滤,支持的过滤项如下:

当天发货 shipInToday
24小时发货 shipIn24Hours
48小时发货 shipIn48Hours
24小时揽收率 <95% getRate24HLv1
24小时揽收率 >=95% getRate24HLv2
24小时揽收率 >=99% getRate24HLv3
48小时揽收率 <95% getRate48HLv1
48小时揽收率 >=95% getRate48HLv2
48小时揽收率 >=99% getRate48HLv3
品质退款率 <=0.005% rfdQualityRateLv1
品质退款率 <=0.15% rfdQualityRateLv2
品质退款率 <=0.30% rfdQualityRateLv3
品质退款率 >0.3% rfdQualityRateLv4
总退款率 <=1% rfdRateLv1
总退款率 <=3% rfdRateLv2
总退款率 <=5% rfdRateLv3
总退款率 >5% rfdRateLv4
7天无理由退换货 noReason7DReturn
实力商家 powerMerchant
履约质量,综合体验分 5星 totalEpScoreLv1
履约质量,综合体验分 4.5星-5.0星 totalEpScoreLv2
履约质量,综合体验分 4星-4.5星 totalEpScoreLv3
履约质量,综合体验分 4星以下 totalEpScoreLv4
认证工厂 certifiedFactory
免费赊账 freeCredit
支持一件代发 isOnePsale
支持包邮 isOnePsaleFreePost
支持抖音密文打单 dyCiphertext
支持快手密文打单 ksCiphertext
支持淘宝密文下单 tbCiphertext
支持拼多多密文下单 pddCiphertext
支持小红书密文下单 xhsCiphertext
支持京东密文下单 jdCiphertext

2. 请求示例代码(Java)

  @Test
    public void One688FenXiaocImageSimilarOfferSearchRequest() 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();
      // 必填
        requestData.put("imgUrl",  "https://gw.alicdn.com/imgextra/i4/2214512037582/O1CN01RsM8GC25sc1rX4UOm_!!2214512037582.jpg");
        JSONArray filters = new JSONArray();
      //包邮
        filters.add("isOnePsaleFreePost");
        requestData.put("filter", filters);
        data.put("request_data", requestData.toJSONString());
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        String response = doHttpRequest(Config.One688FenXiaocImageSimilarOfferSearchRequest, data);
    }

3. 返回结果如下:

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "code": null,
    "message": null,
    "imageSearchUrl": null,
    "imageSearchResult": [
      {
        "offerId": 714865004667,
        "detailUrl": "https://detail.1688.com/offer/714865004667.html?sk=consign",
        "subject": "手持小风扇usb批发桌面宿舍儿童手拿风扇电风扇便携式折叠小型",
        "image": "https://cbu01.alicdn.com/O1CN010GZHEb2NFpLs4Mdz6_!!2215765619934-0-cib.jpg",
        "price": "6.50",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "6.50",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 920689315307,
        "detailUrl": "https://detail.1688.com/offer/920689315307.html?sk=consign",
        "subject": "2025伸缩小风扇USB充电式便携式随身轻声大风力学生宿舍家用神器",
        "image": "https://cbu01.alicdn.com/O1CN016FyAjl2DkNpqsMr9o_!!2219743798647-0-cib.jpg",
        "price": "30.70",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "30.70",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 763918288572,
        "detailUrl": "https://detail.1688.com/offer/763918288572.html?sk=consign",
        "subject": "2021新款风扇桌面USB小风扇大风力学生宿舍床上迷你台式电风扇",
        "image": "https://cbu01.alicdn.com/O1CN01687A5I1ztAW5QjOpE_!!3861076771-0-cib.jpg",
        "price": "6.50",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "6.50",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 807020753748,
        "detailUrl": "https://detail.1688.com/offer/807020753748.html?sk=consign",
        "subject": "【一件包邮】风扇桌面USB小风扇大风力学生宿舍迷你台式电风扇",
        "image": "https://cbu01.alicdn.com/O1CN01BU74Us26eF7yXEH6q_!!2218012647686-0-cib.jpg",
        "price": "9.25",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "9.25",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 941121990036,
        "detailUrl": "https://detail.1688.com/offer/941121990036.html?sk=consign",
        "subject": "可伸缩折叠小风扇办公桌面USB桌面学生宿舍家用静音便携台式风扇",
        "image": "https://cbu01.alicdn.com/O1CN01LHFigS1ykdp2MxzRy_!!3603316617.jpg",
        "price": "10.01",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": true,
        "jyFlag": true,
        "consignPrice": "10.01",
        "multipleConsignPrice": null,
        "distributionFreePostage": true
      },
      {
        "offerId": 811536213993,
        "detailUrl": "https://detail.1688.com/offer/811536213993.html?sk=consign",
        "subject": "批发便携式电风扇迷你折叠USB风扇充电款伸缩桌面静音风扇",
        "image": "https://cbu01.alicdn.com/O1CN016DWduy2Dy7dHa60jQ_!!2218169888677-0-cib.jpg",
        "price": "9.90",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "9.90",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 723129549930,
        "detailUrl": "https://detail.1688.com/offer/723129549930.html?sk=consign",
        "subject": "折叠小风扇便携式家用桌面迷你风扇USB充电台式礼品伸缩风扇跨境",
        "image": "https://cbu01.alicdn.com/O1CN01nc7Df71h4BQxeC8OQ_!!2213271904223-0-cib.jpg",
        "price": "6.50",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "6.50",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 908251612175,
        "detailUrl": "https://detail.1688.com/offer/908251612175.html?sk=consign",
        "subject": "伸缩usb便携小风扇桌面静音折叠学生宿舍办公室充电风扇家用小型",
        "image": "https://cbu01.alicdn.com/O1CN01nJBnsI1QLGwGnVCv9_!!2219594901959-0-cib.jpg",
        "price": "14.20",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "14.20",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 935845170136,
        "detailUrl": "https://detail.1688.com/offer/935845170136.html?sk=consign",
        "subject": "桌面小风扇USB插电款电风扇电扇台扇办公宿舍学生户外大风力折叠",
        "image": "https://cbu01.alicdn.com/O1CN01bkybXL2LM7n5BY8hM_!!2219994119677-0-cib.jpg",
        "price": "13.22",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "13.22",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 705450888253,
        "detailUrl": "https://detail.1688.com/offer/705450888253.html?sk=consign",
        "subject": "2023新款风扇折叠伸缩台扇吊扇挂壁充电式桌面迷你usb小风扇厂家",
        "image": "https://cbu01.alicdn.com/O1CN01lYOFaN21ay4LuL32U_!!2212567967002-0-cib.jpg",
        "price": "8.40",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "8.40",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 773429725161,
        "detailUrl": "https://detail.1688.com/offer/773429725161.html?sk=consign",
        "subject": "新款桌面折叠风扇续航长广角送风伸缩台扇低噪宿舍收纳壁挂风扇",
        "image": "https://cbu01.alicdn.com/O1CN01Ea9n4p1n1KkVkPMT7_!!2216008975029-0-cib.jpg",
        "price": "5.30",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "5.30",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 940557086759,
        "detailUrl": "https://detail.1688.com/offer/940557086759.html?sk=consign",
        "subject": "桌面小风扇插电款电风扇电扇台扇办公宿舍学生户外大风力折叠",
        "image": "https://cbu01.alicdn.com/O1CN01VEhKO323PdkZqUwtY_!!2219874177248-0-cib.jpg",
        "price": "14.99",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": true,
        "jyFlag": true,
        "consignPrice": "14.99",
        "multipleConsignPrice": null,
        "distributionFreePostage": true
      },
      {
        "offerId": 931624829989,
        "detailUrl": "https://detail.1688.com/offer/931624829989.html?sk=consign",
        "subject": "桌面小风扇电风扇小电扇台扇办公宿舍学生户外大风力可折叠包邮代",
        "image": "https://cbu01.alicdn.com/O1CN01BsLsNw1QTW59n1ROQ_!!2219804531977-0-cib.jpg",
        "price": "9.70",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "9.70",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 808605580228,
        "detailUrl": "https://detail.1688.com/offer/808605580228.html?sk=consign",
        "subject": "桌面小风扇USB电风扇小电扇台扇办公宿舍学生户外大风力可折叠",
        "image": "https://cbu01.alicdn.com/O1CN0195KNl32LyaxeiEfZk_!!2217981819761-0-cib.jpg",
        "price": "9.90",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": true,
        "jyFlag": true,
        "consignPrice": "9.90",
        "multipleConsignPrice": null,
        "distributionFreePostage": true
      },
      {
        "offerId": 806032447790,
        "detailUrl": "https://detail.1688.com/offer/806032447790.html?sk=consign",
        "subject": "爆款伸缩风扇便携式折叠USB宿舍家用桌面风扇可爱多功能迷你",
        "image": "https://cbu01.alicdn.com/O1CN01VR42en1GtUHzm1l3m_!!2218021800680-0-cib.jpg",
        "price": "14.00",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": true,
        "jyFlag": true,
        "consignPrice": "14.00",
        "multipleConsignPrice": null,
        "distributionFreePostage": true
      },
      {
        "offerId": 895911576112,
        "detailUrl": "https://detail.1688.com/offer/895911576112.html?sk=consign",
        "subject": "桌面小风扇USB电风扇小电扇台扇办公宿舍学生户外大风力可折叠",
        "image": "https://cbu01.alicdn.com/O1CN0195KNl32LyaxeiEfZk_!!2217981819761-0-cib.jpg",
        "price": "7.90",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "7.90",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 674368951360,
        "detailUrl": "https://detail.1688.com/offer/674368951360.html?sk=consign",
        "subject": "2022新款折叠风扇续航长广角送风拉伸台扇低噪宿舍收纳壁挂风扇",
        "image": "https://cbu01.alicdn.com/O1CN01hEZAJX1Jgbn8InkL5_!!2208977011058-0-cib.jpg",
        "price": "6.00",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "6.00",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 943457109485,
        "detailUrl": "https://detail.1688.com/offer/943457109485.html?sk=consign",
        "subject": "桌面风扇家用小型usb充电便携小风扇伸缩折叠办公室学生宿舍礼品",
        "image": "https://cbu01.alicdn.com/O1CN015dZcHA2IapfNemZqy_!!2219560739303-0-cib.jpg",
        "price": "4.00",
        "tags": [],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "4.00",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 671067577591,
        "detailUrl": "https://detail.1688.com/offer/671067577591.html?sk=consign",
        "subject": "新款桌面折叠风扇续航长广角送风伸缩台扇低噪宿舍收纳壁挂风扇",
        "image": "https://cbu01.alicdn.com/O1CN01fD6qj81xeOVI1HvWq_!!2858426468-0-cib.jpg",
        "price": "6.32",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "6.32",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      },
      {
        "offerId": 799410711496,
        "detailUrl": "https://detail.1688.com/offer/799410711496.html?sk=consign",
        "subject": "新款桌面折叠风扇广角送风伸缩台扇低噪宿舍学生收纳批发",
        "image": "https://cbu01.alicdn.com/O1CN010CZHrL1RYqCe3eogG_!!2216810882124-0-cib.jpg",
        "price": "200.0",
        "tags": [
          {
            "enable": true,
            "text": "48小时发货",
            "type": null,
            "iconUrl": null,
            "linkUrl": null
          }
        ],
        "fenxiaoPrice": null,
        "isJxhy": false,
        "jyFlag": false,
        "consignPrice": "200.0",
        "multipleConsignPrice": null,
        "distributionFreePostage": false
      }
    ],
    "extraInfo": null
  },
  "trace_id": ""
}

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

文档更新时间: 2025-07-16 19:29   作者:admin