item_search_new-按关键字搜索新品数据
onebound.1688.item_search_new
公共参数
请求地址: https://api-gw.onebound.cn/1688/item_search_new
名称 |
类型 |
必须 |
描述 |
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版本 |
请求参数
响应参数
Version: Date:
名称 |
类型 |
必须 |
示例值 |
描述 |
items |
items[] |
0 |
按关键字搜索商品 |
|
page |
Int |
0 |
1 |
页码 |
real_total_results |
Int |
0 |
1000 |
宝贝数量 |
total_results |
Int |
0 |
1000 |
宝贝数量 |
page_size |
Int |
0 |
20 |
接口返回数量 |
pagecount |
Int |
0 |
100 |
总页数 |
item |
item[] |
0 |
宝贝详情数据 |
|
title |
String |
0 |
男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发 |
商品标题 |
pic_url |
String |
0 |
https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg |
宝贝图片 |
promotion_price |
Float |
0 |
169.00 |
优惠价 |
price |
Float |
0 |
169.00 |
价格 |
sales |
Int |
0 |
2000 |
销量 |
num_iid |
Bigint |
0 |
669093370636 |
宝贝ID |
shop_name |
String |
0 |
石狮市领川服装厂 |
卖家昵称 |
area |
String |
0 |
泉州市 |
发货地址 |
sid |
String |
0 |
b2b-221326973628972c61 |
用户ID |
detail_url |
String |
0 |
商品链接 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/1688/item_search_new/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=衣服&page=1&sort="
响应示例
{
"item": [
{
"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "2000+",
"num_iid": "669093370636",
"seller_nick": "石狮市领川服装厂",
"tag_percent": "12.3%",
"area": "泉州市",
"sid": "b2b-221326973628972c61",
"detail_url": "https://detail.1688.com/offer/669093370636.html"
},
{
"title": "2022夏季新款印花短袖t恤女网红同款衣服女韩版百搭中长款上衣女",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Ek7mv41S5oV5YcCvp_!!2744312196-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "668773906932",
"seller_nick": "普宁市洪阳戴紫妮服装厂",
"tag_percent": "17.3%",
"area": "普宁市",
"sid": "b2b-285040931583cf0",
"detail_url": "https://detail.1688.com/offer/668773906932.html"
},
{
"title": "抖音质量磨毛双面德绒短袖t恤女立体卡通夏2022新款上衣大码女装",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ihTAw31Vqw6C0UByX_!!2213014272705-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "200+",
"num_iid": "670585170610",
"seller_nick": "广州克里贸易有限公司",
"tag_percent": "9%",
"area": "普宁市",
"sid": "b2b-2213014272705d647f",
"detail_url": "https://detail.1688.com/offer/670585170610.html"
},
{
"title": "韩路女装 2022春夏新款卡通印花短袖T恤女ins风纯棉宽松潮流体恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vPvBu722OtAF9rxw2_!!3910967111-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "6万+",
"num_iid": "668912014686",
"seller_nick": "瑞安市萌越贸易有限公司",
"tag_percent": "17%",
"area": "瑞安市",
"sid": "b2b-391096711196312",
"detail_url": "https://detail.1688.com/offer/668912014686.html"
},
{
"title": "撞色条纹短袖针织衫女2022夏季新款休闲百搭别致上衣ins显瘦薄款",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ztb9V421Yg1BzxUC7_!!2213249306997-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "671716125800",
"seller_nick": "广州小仙妮子服装厂",
"tag_percent": "4.7%",
"area": "广州市",
"sid": "b2b-2213249306997da12a",
"detail_url": "https://detail.1688.com/offer/671716125800.html"
},
{
"title": "夏新款潮流男女重磅250克落肩半袖t恤供应学生班服宽松嘻哈街舞服",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lJUgSo1uVkAiNDhwz_!!2209929186043-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "2万+",
"num_iid": "670169572856",
"seller_nick": "广州旺者归莱服装有限公司",
"tag_percent": "10.8%",
"area": "广州市",
"sid": "b2b-22099291860439e3d0",
"detail_url": "https://detail.1688.com/offer/670169572856.html"
},
{
"title": "东南亚跨境全涤男士短袖T恤亚马逊夏季新款短袖上衣时尚潮印花T恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01BeqZdv25bf3xdIOEu_!!2213760247545-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1万+",
"num_iid": "671850915594",
"seller_nick": "揭阳市衫少服饰有限公司",
"tag_percent": "6.9%",
"area": "揭阳市",
"sid": "b2b-22137602475451e023",
"detail_url": "https://detail.1688.com/offer/671850915594.html"
},
{
"title": "韩路女装 主推款纯棉短袖T恤女2022春夏新品宽松潮流趣味印花体恤",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01v1B5s322OtADFyEOW_!!3910967111-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "24万+",
"num_iid": "668176444969",
"seller_nick": "瑞安市萌越贸易有限公司",
"tag_percent": "17%",
"area": "瑞安市",
"sid": "b2b-391096711196312",
"detail_url": "https://detail.1688.com/offer/668176444969.html"
},
{
"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "3万+",
"num_iid": "668987018070",
"seller_nick": "石狮市艾迪斯顿服装厂",
"tag_percent": "15.9%",
"area": "泉州市",
"sid": "b2b-22132036914233b9ff",
"detail_url": "https://detail.1688.com/offer/668987018070.html"
},
{
"title": "当季新品 趋势热卖",
"pic_url": null,
"promotion_price": null,
"price": null,
"sales": null,
"num_iid": null,
"seller_nick": null,
"tag_percent": null,
"area": null,
"sid": null,
"detail_url": "https://detail.1688.com/offer/.html"
},
{
"title": "纯棉t恤男2022夏季新款短袖T恤男圆领半袖宽松潮流衣服打底衫男",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018WnzOm1DmCvnSox0K_!!2212492580258-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "671351089756",
"seller_nick": "汕头市潮阳区铜盂诗美嘉服装厂",
"tag_percent": "8.3%",
"area": "汕头市",
"sid": "b2b-2212492580258e6ac6",
"detail_url": "https://detail.1688.com/offer/671351089756.html"
},
{
"title": "中袖t恤女2022年新款女装气质polo领莫代尔半袖体恤撞色收腰上衣",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN019VuwdN1vYK19Qcjgl_!!2242696184-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "3000+",
"num_iid": "670971673377",
"seller_nick": "广州声歌服饰有限公司",
"tag_percent": "45.4%",
"area": "广州市",
"sid": "b2b-2242696184",
"detail_url": "https://detail.1688.com/offer/670971673377.html"
},
{
"title": "潮迈克男士短袖T恤衣服潮牌潮流半袖男装2022新款夏季修身体恤衫",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01k1ZXYL2N3uxtkFbjD_!!2212460019908-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "200+",
"num_iid": "671819478208",
"seller_nick": "石狮市祥志日用品商行",
"tag_percent": "9.7%",
"area": "",
"sid": "b2b-22124600199086d3a0",
"detail_url": "https://detail.1688.com/offer/671819478208.html"
},
{
"title": "100%棉t恤短袖男修身潮流纯色280g丝光棉男士半袖圆领上衣中青年",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018rR3nq1Yidm4jNvRE_!!2212372513093-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "7000+",
"num_iid": "669931288096",
"seller_nick": "桐乡市梧桐辉诺服饰商行",
"tag_percent": "16.3%",
"area": "桐乡市",
"sid": "b2b-22123725130939dd36",
"detail_url": "https://detail.1688.com/offer/669931288096.html"
},
{
"title": "2022新款弹力直筒打底上衣五分袖小衫网纱立领印花T恤女装夏季潮",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nx3VpR23uJy6lgtVW_!!2260697315-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "400+",
"num_iid": "671337941177",
"seller_nick": "潮州市潮安区金石镇骏龙制衣厂",
"tag_percent": "39.7%",
"area": "潮州市",
"sid": "b2b-2260697315",
"detail_url": "https://detail.1688.com/offer/671337941177.html"
},
{
"title": "厂家直销翻领冰丝短袖t恤男式商务休闲条纹宽松薄款Polo衫男装潮",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lur0VS1uqoOGKJYOf_!!2213204496089-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "700+",
"num_iid": "669987872360",
"seller_nick": "桐乡市濮院柏梁服装厂",
"tag_percent": "19%",
"area": "桐乡市",
"sid": "b2b-221320449608977b92",
"detail_url": "https://detail.1688.com/offer/669987872360.html"
},
{
"title": "现货供应休闲日系短袖T恤男绣潮流日式绣花贴布圆领T恤男外贸衫",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01o0ZM4b29ayw5yQoaR_!!2209917828085-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "300+",
"num_iid": "670628937468",
"seller_nick": "广州市云格服饰有限公司",
"tag_percent": "35.1%",
"area": "广州市",
"sid": "b2b-2209917828085ceab7",
"detail_url": "https://detail.1688.com/offer/670628937468.html"
},
{
"title": "TKPA高街头复古美式oldschool做旧水洗徽章i短袖T恤男女ins国潮牌",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01FMyJtv1fE8i6JzwT7_!!3344093974-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "600+",
"num_iid": "670665770082",
"seller_nick": "广州悦享商贸有限公司",
"tag_percent": "32.7%",
"area": "广州市",
"sid": "b2b-334409397456d89",
"detail_url": "https://detail.1688.com/offer/670665770082.html"
},
{
"title": "中年男士T恤宽松爸爸夏装短袖宽条纹夏季上衣服有口袋中",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01s8ypcK1jD07xKzQhW_!!2211188044513-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "500+",
"num_iid": "671263051411",
"seller_nick": "桐乡市濮院弘伙服装厂",
"tag_percent": "18%",
"area": "嘉兴市",
"sid": "b2b-2211129648221b6b4d",
"detail_url": "https://detail.1688.com/offer/671263051411.html"
},
{
"title": "2022夏季新款宽松T恤短款温柔风上衣条纹冰丝针织衫女短袖",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01XFne181n3A8yzQGA0_!!2213769605033-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "700+",
"num_iid": "671604715165",
"seller_nick": "广州觅婷阁服装商行",
"tag_percent": null,
"area": "广州市",
"sid": "b2b-2213769605033305d4",
"detail_url": "https://detail.1688.com/offer/671604715165.html"
},
{
"title": "2022夏季新款五分袖t恤小清新连帽抽绳百搭休闲青少年套头衫上衣",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ODtwTy1oe5h8ZddYU_!!2212454665249-0-cib.jpg",
"promotion_price": null,
"price": null,
"sales": "1000+",
"num_iid": "670454273152",
"seller_nick": "石狮市崛夜雪锋服装厂",
"tag_percent": "16.3%",
"area": "石狮市",
"sid": "b2b-2212454665249d3f37",
"detail_url": "https://detail.1688.com/offer/670454273152.html"
}
],
"data_from": "1688app",
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:19 max:11000",
"execution_time": "2.566",
"server_time": "Beijing/2022-04-15 15:33:41",
"client_ip": "106.6.33.38",
"call_args": [],
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "4.29MB",
"request_id": "gw-1.62591fd317826",
"last_id": "886371758"}相关资料
错误码解释
状态代码(error_code) |
状态信息 |
详细描述 |
是否收费 |
0000 |
success |
接口调用成功并返回相关数据 |
是 |
2000 |
Search success but no result |
接口访问成功，但是搜索没有结果 |
是 |
4000 |
Server internal error |
服务器内部错误 |
否 |
4001 |
Network error |
网络错误 |
否 |
4002 |
Target server error |
目标服务器错误 |
否 |
4003 |
Param error |
用户输入参数错误 |
忽略 |
4004 |
Account not found |
用户帐号不存在 |
忽略 |
4005 |
Invalid authentication credentials |
授权失败 |
忽略 |
4006 |
API stopped |
您的当前API已停用 |
忽略 |
4007 |
Account stopped |
您的账户已停用 |
忽略 |
4008 |
API rate limit exceeded |
并发已达上限 |
忽略 |
4009 |
API maintenance |
API维护中 |
忽略 |
4010 |
API not found with these values |
API不存在 |
忽略 |
4012 |
Please add api first |
请先添加api |
忽略 |
4013 |
Number of calls exceeded |
调用次数超限 |
忽略 |
4014 |
Missing url param |
参数缺失 |
忽略 |
4015 |
Wrong pageToken |
参数pageToken有误 |
忽略 |
4016 |
Insufficient balance |
余额不足 |
忽略 |
4017 |
timeout error |
请求超时 |
否 |
5000 |
unknown error |
未知错误 |
否 |