图搜内贸代发商品
图搜内贸代发商品,根据提供的图片,在1688查找相似商品。对于搜索出来的商品,可以通过调用获取商品详情获取商品详情信息。
一、请求参数
请求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 |
二、请求示例代码
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); }三、返回结果
{ "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值,返回字段说明见文档