阿里巴巴按关键字搜索新品数据 API

最新推荐文章于 2024-07-19 15:28:13 发布

分享干货的猫

最新推荐文章于 2024-07-19 15:28:13 发布

阅读量248

点赞数 1

分类专栏： api接口网站搭建 api 文章标签：服务器 servlet 运维 1688api接口 api接口

本文链接：https://blog.csdn.net/Noah_ZX/article/details/126056600

版权

api 同时被 3 个专栏收录

252 篇文章 8 订阅

订阅专栏

api接口

251 篇文章 6 订阅

订阅专栏

网站搭建

55 篇文章 1 订阅

订阅专栏

一、参数

公共参数

请求地址: 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版本

请求参数

请求参数：q=衣服&page=1&sort=

参数说明：q：搜索关键字
page:翻页
sort:排序(normal综合,va_rmdarkgmv30rt成交额,bid价格升序，_bid价格降序)

响应参数

Version: Date:

名称	类型	示例值	描述
items	items[]		按关键字搜索商品
page	Int	1	页码
real_total_results	Int	1000	宝贝数量
total_results	Int	1000	宝贝数量
page_size	Int	20	接口返回数量
pagecount	Int	100	总页数
item	item[]		宝贝详情数据

二、示例

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_search_new/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=衣服&page=1&sort="

前往获取key和secret

响应示例

{
	"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": "data error",
  "reason": "data error",
  "error_code": "5000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "1688",
  "request_id": "15ee0ffc041242"}

三、错误码解释

状态代码(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	未知错误	否