前往测试接口
item_search-按关键字搜索商品 注册开通
onebound.1688.item_search
一、公共参数
名称 | 类型 | 必须 | 描述 |
key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
version | String | 否 | API版本 |
二、请求参数
请求参数：q=充电宝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit]
(bid:总价,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数 page_size:每页宝贝数量，默认40
filter:额外的过滤参数，如：filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000
filtId 过滤：48小时发货,7+天包换,赠运费险,免费赊账;
activityType 优惠类型:包邮，产地货源，伙拼，手机专享价
city 地区：地区名
quantityBegin 起订量：数字\
三、响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
items | items[] | 0 | 按关键字搜索商品 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=充电宝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter="四、响应示例
"items": {
"page": "1",
"real_total_results": 1900,
"total_results": 1900,
"page_size": 19,
"pagecount": 100,
"item": [
{
"title": "22.5W充电宝30000毫安大容量可LOGO户外便捷充外贸快充移动电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01BuDTBe1V8Vi0H8NFa_!!2208743662608-0-cib.jpg",
"promotion_price": "22.51",
"price": "22.51",
"sales": 11670,
"num_iid": "656709671078",
"seller_nick": "东莞市德拉博电子科技有限公司",
"tag_percent": "25%",
"area": "东莞市",
"detail_url": "https://detail.1688.com/offer/656709671078.html"
},
{
"title": "手机通用自带线充电宝20000毫安 镜面快充大容量移动电源一件代发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01y2HUcv1pkKe97mB9y_!!2201235165398-0-cib.jpg",
"promotion_price": "16.20",
"price": "16.20",
"sales": 1442261,
"num_iid": "616296320845",
"seller_nick": "深圳市二筒科技有限公司",
"tag_percent": "13%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/616296320845.html"
},
{
"title": "亚马逊爆款 便携充电宝10000毫安 超级快充PD22.5W 新款移动 电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN014TFjdG1V8VhoseQyJ_!!2208743662608-0-cib.jpg",
"promotion_price": "35.60",
"price": "35.60",
"sales": 0,
"num_iid": "678212553680",
"seller_nick": "东莞市德拉博电子科技有限公司",
"tag_percent": "25%",
"area": "东莞市",
"detail_url": "https://detail.1688.com/offer/678212553680.html"
},
{
"title": "迷你便携自带线20000毫安大容量充电宝 可爱小巧礼品移动电源批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Vh8sfx2AVm4L6zELK_!!3245838209-0-cib.jpg",
"promotion_price": "22.00",
"price": "22.00",
"sales": 89013,
"num_iid": "669584150772",
"seller_nick": "深圳市捷华仕实业有限公司",
"tag_percent": "19%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/669584150772.html"
},
{
"title": "批发迷你自带四线充电宝20000毫安大容量移动电源礼品定 制logo",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01JzOerr20fG6SC5VBN_!!2201483386876-0-cib.jpg",
"promotion_price": "15.00",
"price": "15.00",
"sales": 211743,
"num_iid": "674347529628",
"seller_nick": "深圳市古黛科技有限公司",
"tag_percent": "22%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/674347529628.html"
},
{
"title": "一件代发大容量充电宝50000毫安60000毫安数显快充10W移动电源8万",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/999/810/21587018999_40970201.jpg",
"promotion_price": "60.97",
"price": "60.97",
"sales": 40506,
"num_iid": "619661034684",
"seller_nick": "深圳腾之乐科技有限公司",
"tag_percent": "12%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/619661034684.html"
},
{
"title": "迷你充电宝便携快充大容量移动电源礼品印制LOGO共享定20000毫安",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01APuqZf1g6BSw3VZXB_!!2210135524092-0-cib.jpg",
"promotion_price": "9.50",
"price": "9.50",
"sales": 79857,
"num_iid": "676593972196",
"seller_nick": "深圳市森敏电子有限公司",
"tag_percent": "16%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/676593972196.html"
},
{
"title": "充电宝可爱卡通大容量10000毫安小巧轻薄迷你移动电源定 印制LOGO",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Xg4fPQ2K5LNAzU0Ji_!!2212924439505-0-cib.jpg",
"promotion_price": "7.99",
"price": "7.99",
"sales": 94211,
"num_iid": "662073502019",
"seller_nick": "深圳市润星丰科技有限公司",
"tag_percent": "13%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/662073502019.html"
},
{
"title": "跨境外贸大容量充电宝双向PD快充移动电源15000毫安手机充电宝",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/390/630/23693036093_1416795072.jpg",
"promotion_price": "0.94",
"price": "0.94",
"sales": 0,
"num_iid": "656329451934",
"seller_nick": "深圳市坪山新区美维达表配件厂",
"tag_percent": "16%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/656329451934.html"
},
{
"title": "罗马仕充电宝批发20000毫安便携数显聚合物快充移动电源一件代发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01IPwAEx1ENIw65QinG_!!2261690339-0-cib.jpg",
"promotion_price": "79.00",
"price": "79.00",
"sales": 15578,
"num_iid": "571179136139",
"seller_nick": "南通联沃贸易有限公司",
"tag_percent": "12%",
"area": "南通市",
"detail_url": "https://detail.1688.com/offer/571179136139.html"
},
{
"title": "充电宝批发迷你小巧便携超大容量20000毫安移动电源礼品广告定 制",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01BPQv7B1wVP8WfrJPT_!!3294836313-0-cib.jpg",
"promotion_price": "7.90",
"price": "7.90",
"sales": 1063604,
"num_iid": "671771396625",
"seller_nick": "深圳市博鸿恒业科技有限公司",
"tag_percent": "6%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/671771396625.html"
},
{
"title": "跨境便携移动电源 共享大容量自带线20000毫安无线快充充电宝批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01j1tkVb2MoLVnw3SB5_!!2208547509874-0-cib.jpg",
"promotion_price": "59.30",
"price": "59.30",
"sales": 19784,
"num_iid": "676034298430",
"seller_nick": "深圳市普顺泰科技有限公司",
"tag_percent": "18%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/676034298430.html"
},
{
"title": "充电宝批发小巧便携自带线20000毫安迷你大容量定 制logo移动电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01zK3ZD41pVDcreUv6m_!!2200729845365-0-cib.jpg",
"promotion_price": "13.86",
"price": "13.86",
"sales": 732745,
"num_iid": "666088073797",
"seller_nick": "深圳腾之乐科技有限公司",
"tag_percent": "12%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/666088073797.html"
},
{
"title": "适用华为40W超级双向快充充电宝大容量20000毫安超薄移动电源批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01DFhwWI1SohIGIWB6X_!!3569272294-0-cib.jpg",
"promotion_price": "33.00",
"price": "33.00",
"sales": 15167,
"num_iid": "661255134000",
"seller_nick": "深圳市联信科电子科技有限公司",
"tag_percent": "19%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/661255134000.html"
},
{
"title": "超薄充电宝批发制定logo 便携式超大容量自带线20000毫安移动电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZeiwS623cSS9gOmHm_!!2919217276-0-cib.jpg",
"promotion_price": "20.00",
"price": "20.00",
"sales": 18513,
"num_iid": "636575020703",
"seller_nick": "深圳市大通元实业有限公司",
"tag_percent": "24%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/636575020703.html"
},
{
"title": "新款迷你创意大容量充电宝20000毫安自带四线便携无线移动电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01PIdnxo1D1UR4aL2Ut_!!2210347000156-0-cib.jpg",
"promotion_price": "31.00",
"price": "31.00",
"sales": 967403,
"num_iid": "635273849482",
"seller_nick": "深圳市亚洪实业有限公司",
"tag_percent": "27%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/635273849482.html"
},
{
"title": "批发自带线共享大容量充电宝20000毫安便携移动电源礼品定 制logo",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nqYvDu1aWOQyy2JQc_!!2207886923337-0-cib.jpg",
"promotion_price": "26.00",
"price": "26.00",
"sales": 55355,
"num_iid": "678370618370",
"seller_nick": "深圳市沣霖科技有限公司",
"tag_percent": "14%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/678370618370.html"
},
{
"title": "快充迷你充电宝制定logo 小巧便携冲大容量20000毫安移动电源批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01im73Bm1EUdMXGlNj6_!!2214149790355-0-cib.jpg",
"promotion_price": "14.30",
"price": "14.30",
"sales": 151175,
"num_iid": "678831084212",
"seller_nick": "深圳市厚荣佳业实业有限公司",
"tag_percent": "10%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/678831084212.html"
},
{
"title": "跨境户外太阳能超大容量移动电源 共享自带线30000毫安充电宝批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01hKGNe11JdrQPkUIST_!!2075311052-0-cib.jpg",
"promotion_price": "39.50",
"price": "39.50",
"sales": 17465,
"num_iid": "669374028847",
"seller_nick": "深圳市嘉丽都电子科技有限公司",
"tag_percent": "27%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/669374028847.html"
},
{
"title": "共享自带线迷你20000毫安 礼品充电宝批发制logo超大容量移动电源",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018ky2It1EGR4aP6nD2_!!2210054220324-0-cib.jpg",
"promotion_price": "17.60",
"price": "17.60",
"sales": 1943050,
"num_iid": "660231426918",
"seller_nick": "深圳市柒月数码科技有限公司",
"tag_percent": "15%",
"area": "深圳市",
"detail_url": "https://detail.1688.com/offer/660231426918.html"
}
],
"data_from": "1688app"
},
"error_code": "0000",
"reason": "ok",
"secache": "73101023fc40765ba2f764a79fd74c33",
"secache_time": 1660979135,
"secache_date": "2022-08-20 15:05:35",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:22 max:10000 all[100=22+51+27];expires:2030-12-31",
"execution_time": "2.255",
"server_time": "Beijing/2022-08-20 15:05:35",
"client_ip": "106.6.39.33",
"call_args": {
"q": "充电宝",
"start_price": "1",
"end_price": "0",
"page": "1",
"cat": "0",
"page_size": "40"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "4.38MB",
"request_id": "gw-1.630087bd4016a",
"last_id": "1163327310"
}
