item_search_new-按关键字搜索新品数据 [查看演示] API测试工具 注册开通
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 | https://detail.1688.com/offer/669093370636.html | 商品链接 |
请求示例
-- 请求示例 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 | 未知错误 | 否 |