如何借助API实现自动化采集，微店根据关键词取商品列表 API接口数据调用

micro.item_search

公共参数

查看API调用文档，可免费测试

名称	类型	必须	描述
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=

参数说明：q:关键词, page:页码

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	HYKE x The North Face北面tnf联名中长款面包服羽绒服秋冬加厚保暖情侣外套	商品标题
num_iid	String	0	3490287840	宝贝ID
price	Float	0	799	价格
orginal_price	Float	0	799	原价格
promotion_price	Float	0	799	优惠价格
pic_url	String	0	https://si.geilicdn.com/pcitem1232497572-78fb000001765d42a8050a217205-unadjust_958_958.jpeg	宝贝图片
sales	Int	0	14830	销量
seller_id	String	0		卖家ID
seller_nick	String	0		掌柜昵称
detail_url	String	0	https://weidian.com/item.html?itemID=3490287840	宝贝链接

 

响应示例

{
		"items": {
		"q": "女装",
		"page": 1,
		"page_size": 100,
		"real_total_results": 10000,
		"total_results": 10000,
		"pagecount": 100,
		"data_from": "micro",
		"item": [
			{
				"title": "HYKE x The North Face北面tnf联名中长款面包服羽绒服秋冬加厚保暖情侣外套",
				"num_iid": 3490287840,
				"price": 799,
				"orginal_price": 799,
				"promotion_price": 799,
				"pic_url": "https://si.geilicdn.com/pcitem1232497572-78fb000001765d42a8050a217205-unadjust_958_958.jpeg",
				"sales": 43,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3490287840"
			},
			{
				"title": "Sup联名牛仔衣外套supreme联名驴牌牛仔外套 1v牛仔外套 驴牛仔外套 1v夹克 牛仔夹克\n",
				"num_iid": 3470898024,
				"price": 799,
				"orginal_price": 799,
				"promotion_price": 799,
				"pic_url": "https://si.geilicdn.com/wdseller1515987046-618f000001754f6b1b950a217205_1080_1350.jpg?w=1125",
				"sales": 1131,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3470898024"
			},
			{
				"title": "Nike Classic X Sport 姜黄色两面穿棉服 男女情侣秋冬宽松保暖夹克外套",
				"num_iid": 3495394879,
				"price": 249,
				"orginal_price": 249,
				"promotion_price": 249,
				"pic_url": "https://si.geilicdn.com/pcitem1232497572-35fd0000017653c8ba180a217205-unadjust_800_799.jpeg",
				"sales": 25,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3495394879"
			},
			{
				"title": "【专柜正品】Adidas阿迪达斯外套女安琪拉 运动休闲上衣三叶草加绒加厚夹克毛呢情侣甜心小熊开衫卫衣元素棉衣EE7399",
				"num_iid": 3991988902,
				"price": 239,
				"orginal_price": 239,
				"promotion_price": 239,
				"pic_url": "https://si.geilicdn.com/pcitem207866614-4c3900000174cee115db0a217205_1088_1330.jpg",
				"sales": 47,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3991988902"
			},
			{
				"title": "Burbe*ry 19秋冬新款，王牌代工真品！新式螺纹撞色设计，60%羊毛30%羊绒打造，情侣款圆领套头毛衣",
				"num_iid": 2973285371,
				"price": 338,
				"orginal_price": 338,
				"promotion_price": 338,
				"pic_url": "https://si.geilicdn.com/wdseller982250730-43d900000173c514cc560a21348d_1124_842.jpg",
				"sales": 396,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=2973285371"
			},
			{
				"title": "小香家牛货～满满高级感！系带针织开衫大衣\n",
				"num_iid": 3993498117,
				"price": 1680,
				"orginal_price": 1680,
				"promotion_price": 1680,
				"pic_url": "https://si.geilicdn.com/wdseller901474021863-4e7100000174d340ee750a217216_1440_1920.jpg?w=750",
				"sales": 1,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3993498117"
			},
			{
				"title": "剪刀手大毛领长款厚实保暖女士鹅绒服羽绒服外套",
				"num_iid": 4246323440,
				"price": 868,
				"orginal_price": 868,
				"promotion_price": 868,
				"pic_url": "https://si.geilicdn.com/weidian1496872223-5ae40000017666eebb1f0a20b7b9_560_800.jpg",
				"sales": 8,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4246323440"
			},
			{
				"title": "207806.L*P家秋冬水貂镶边连帽2色斗篷大衣\n",
				"num_iid": 4253675526,
				"price": 3390,
				"orginal_price": 3390,
				"promotion_price": 3390,
				"pic_url": "https://si.geilicdn.com/wdseller901353083325-4d180000017683f22f780a21348d-unadjust_1124_1438.jpeg",
				"sales": 1,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4253675526"
			},
			{
				"title": "百分百zp订单！gu@cci 千格鸟高级成衣套装 外套➕半身裙！贵妇和仙女们都可以get起来",
				"num_iid": 3932701598,
				"price": 1050,
				"orginal_price": 1050,
				"promotion_price": 1050,
				"pic_url": "https://si.geilicdn.com/wdseller1419679334-02bb00000174498548c50a217216_1080_1440.jpg?w=1242",
				"sales": 22,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3932701598"
			},
			{
				"title": "The North Face北面羽绒服男女同款2020新款秋冬短款外套女羽绒服联名Jacket脑死亡",
				"num_iid": 4036752883,
				"price": 599.9,
				"orginal_price": 599.9,
				"promotion_price": 599.9,
				"pic_url": "https://si.geilicdn.com/wdseller708662266-25fa00000176cd7f210d0a21c2a7_1242_1239.jpg",
				"sales": 756,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4036752883"
			},
			{
				"title": "【0115上新地素da/zzle 21年早春新款z】实力渠道！合作地素da/zzle  21年早春新款亮片毛衣",
				"num_iid": 4278540307,
				"price": 318,
				"orginal_price": 318,
				"promotion_price": 318,
				"pic_url": "https://si.geilicdn.com/weidian901528394022-6da70000017700e6dfb00a20b7b9_1080_1431.jpg",
				"sales": 355,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4278540307"
			},
			{
				"title": "硬货 来晚了 纯纯纯正单 马克思maxmara羊绒大衣经典款情侣冬季风衣101801呢子服",
				"num_iid": 3028848079,
				"price": 2580,
				"orginal_price": 2580,
				"promotion_price": 2580,
				"pic_url": "https://si.geilicdn.com/wdseller1356285568-7a8200000175ad2fab750a217216-unadjust_1242_1242.jpeg",
				"sales": 351,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3028848079"
			},
			{
				"title": "【嘟嘟推荐】重磅‼️皮草夫妇👉Mr&Mrs Italy MMI女士皮草派克大衣外套（下单前可带图咨询嘟嘟）",
				"num_iid": 3027934363,
				"price": 4400,
				"orginal_price": 4400,
				"promotion_price": 4400,
				"pic_url": "https://si.geilicdn.com/weidian1419679334-29e30000016ddc7776f60a21c2a7_1440_1920.jpg",
				"sales": 53,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3027934363"
			},
			{
				"title": "THE NORTH FACE北面潮牌羽绒服男女同款短款外套女羽绒服情侣装1996Nuptse经典复刻",
				"num_iid": 4075831084,
				"price": 599.9,
				"orginal_price": 599.9,
				"promotion_price": 599.9,
				"pic_url": "https://si.geilicdn.com/wdseller708662266-2ee000000176e28c0b6e0a217205_800_800.jpg",
				"sales": 464,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4075831084"
			},
			{
				"title": "【年底狂欢购】蒙口家liriope 20F/W 新款女士亮面连帽短款羽绒服外套，袁姗姗同款",
				"num_iid": 4261382075,
				"price": 886.44,
				"orginal_price": 886.44,
				"promotion_price": 886.44,
				"pic_url": "https://si.geilicdn.com/pcitem1322063473-7f2000000176ac8a4bc40a21348d-unadjust_1080_1080.jpeg",
				"sales": 219,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4261382075"
			},
			{
				"title": "20年秋冬季新款外贸女装纯棉加绒圆领卫衣休闲运动服刺绣套衫女",
				"num_iid": 3547970105,
				"price": 108,
				"orginal_price": 108,
				"promotion_price": 108,
				"pic_url": "https://si.geilicdn.com/wdseller328987272-27c8000001771ab9a2e50a217216_1080_1018.jpg",
				"sales": 34,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3547970105"
			},
			{
				"title": "Acne新款【19秋冬新款】女士新品短款双排扣羊毛混纺双面呢外套两色舒适 廓形宽松版型女外套羊毛大衣",
				"num_iid": 3027160034,
				"price": 499,
				"orginal_price": 499,
				"promotion_price": 499,
				"pic_url": "https://si.geilicdn.com/weidianw631187-25060000016dd7a92e0c0a20e432_960_960.jpg",
				"sales": 36,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3027160034"
			},
			{
				"title": "【1120上新纯正外贸订单ydxz1】男女同款！镇店王炸款！蒙口羽绒服，陈奕迅同款，MAYA经典收腰，出入专g无压力🍐",
				"num_iid": 3240020511,
				"price": 780,
				"orginal_price": 780,
				"promotion_price": 780,
				"pic_url": "https://si.geilicdn.com/weidian1455461168-73760000016f70ab3ea60a20b7b9_1080_1440.jpg",
				"sales": 358,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3240020511"
			},
			{
				"title": "207738.CHLO*家秋冬保暖羊毛小皮草外套\n",
				"num_iid": 4248997756,
				"price": 750,
				"orginal_price": 750,
				"promotion_price": 750,
				"pic_url": "https://si.geilicdn.com/wdseller901353083325-4f4f000001766f6b17300a20b7b9-unadjust_1124_1500.jpeg",
				"sales": 1,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4248997756"
			},
			{
				"title": "【现货】秋冬新款🔥🔥，小香风立领水钻双排扣羊气粗花呢外套，温和的日黄色中和了霸气味道，颜色超级显白，高雅气质S～L",
				"num_iid": 4090245934,
				"price": 390,
				"orginal_price": 390,
				"promotion_price": 390,
				"pic_url": "https://si.geilicdn.com/weidian1501837623-3721000001757213e5c30a20b7b9_1080_1440.jpg",
				"sales": 0,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4090245934"
			},
			{
				"title": "【日单正品】双色针织羊绒衫女 亮钻 花色羊毛针织衫衫 加厚百搭毛衣",
				"num_iid": 4259833427,
				"price": 126.42,
				"orginal_price": 126.42,
				"promotion_price": 126.42,
				"pic_url": "https://si.geilicdn.com/pcitem1516783014-10e500000176a25db8d90a217216_800_800.jpg",
				"sales": 0,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4259833427"
			},
			{
				"title": "独家新款💜Bottega Veneta2021最新款香芋紫色粗线羊毛长款开衫毛衣显气质显白显瘦白富美必备",
				"num_iid": 4279280572,
				"price": 799,
				"orginal_price": 799,
				"promotion_price": 799,
				"pic_url": "https://si.geilicdn.com/wdseller1215809282-5e2700000177014cc6770a217205_1124_1124.jpg?w=1125",
				"sales": 79,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4279280572"
			},
			{
				"title": "Max Teddy 走秀款～连帽泰迪烟草色 Tobacco 连帽款泰迪熊大衣 男女同款毛毛大衣",
				"num_iid": 4204699848,
				"price": 1880,
				"orginal_price": 1880,
				"promotion_price": 1880,
				"pic_url": "https://si.geilicdn.com/weidian313839116-2fc0000001760f7426090a217216_1069_1048.jpg",
				"sales": 14,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4204699848"
			},
			{
				"title": "原厂Chanel/香奈儿20ss早秋新款不规则开衫百搭长袖毛衣女",
				"num_iid": 4033593235,
				"price": 850,
				"orginal_price": 850,
				"promotion_price": 850,
				"pic_url": "https://si.geilicdn.com/open1817377764-1234478995-703d000001751e43f3250a21924b_600_800.jpg",
				"sales": 459,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4033593235"
			},
			{
				"title": "漫画少女感！～英国小众牌娃娃领笑脸方块编织感针织开衫毛衣～时髦显瘦 一秒沦陷的俏皮减龄！",
				"num_iid": 4267524953,
				"price": 179,
				"orginal_price": 179,
				"promotion_price": 179,
				"pic_url": "https://si.geilicdn.com/open1026753490-1234478995-7ad600000176d143b3ff0a21a31a_828_1082.jpg?w=750",
				"sales": 30,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4267524953"
			},
			{
				"title": "【代工厂渠道货】Max Mara Manuela系列 大衣 韩国高丽订单货 骆驼绒水波纹 大西装领经典大衣",
				"num_iid": 4101754719,
				"price": 2980,
				"orginal_price": 2980,
				"promotion_price": 2980,
				"pic_url": "https://si.geilicdn.com/wdseller1477435758-070e00000175828afb3e0a217205-unadjust_1440_1920.jpeg",
				"sales": 12,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4101754719"
			},
			{
				"title": "Jil S@nder／极简美学连帽方格大外套 空气感面包羽绒服2色",
				"num_iid": 4037995257,
				"price": 788,
				"orginal_price": 788,
				"promotion_price": 788,
				"pic_url": "https://si.geilicdn.com/weidianw1162278-6563000001752bf298d30a21c2a8_1080_1080.jpg",
				"sales": 17,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4037995257"
			},
			{
				"title": "100%贸易公司授权正品单！上身立马显瘦20斤的外套‼️全球VIP限量款双排扣真丝羊毛GG西装外套！",
				"num_iid": 3724392101,
				"price": 1980,
				"orginal_price": 1980,
				"promotion_price": 1980,
				"pic_url": "https://si.geilicdn.com/wdseller1419679334-24fc00000172cc9eac710a20b7b9_1080_1080.jpg?w=1242",
				"sales": 8,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3724392101"
			},
			{
				"title": "ami毛衣爱心毛衣爱心卫衣Ami情侣红色桃心A毛线绣圆领羊毛毛衣温情爆款 法式极简Ami",
				"num_iid": 3616293384,
				"price": 599,
				"orginal_price": 599,
				"promotion_price": 599,
				"pic_url": "https://si.geilicdn.com/wdseller1515987046-73a5000001763dec46900a20b7b9-unadjust_800_800.jpeg?w=1125",
				"sales": 785,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3616293384"
			},
			{
				"title": "【代购版本】蒙口/Moncler maya经典羽绒服哑光面 亮面陈奕迅同款男士外套短款女士上衣玛雅短款保暖带帽羽绒服",
				"num_iid": 4231822607,
				"price": 988,
				"orginal_price": 988,
				"promotion_price": 988,
				"pic_url": "https://si.geilicdn.com/wdseller1514864433-1130000001764b9c9ba90a21c2a7-unadjust_1000_986.jpeg",
				"sales": 1421,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4231822607"
			},
			{
				"title": "过验FEAR OF GOD复线ESSENTIALS羽绒棉fog棉服宽松欧美高街拉链外套情侣款男女同款",
				"num_iid": 3843824725,
				"price": 598,
				"orginal_price": 598,
				"promotion_price": 598,
				"pic_url": "https://si.geilicdn.com/wdseller1487081880-2511000001753632653c0a21348d_1242_1242.jpg?w=1242",
				"sales": 1721,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=3843824725"
			},
			{
				"title": "Balenciaga/ 巴黎世家 三粒扣手臂绣标西装外套(MS獨家定制 BLCG男女同款西装外",
				"num_iid": 4066620126,
				"price": 899,
				"orginal_price": 899,
				"promotion_price": 899,
				"pic_url": "https://si.geilicdn.com/weidian1419674837-587b000001754fa5e5b00a20b7b9_1080_1080.jpg",
				"sales": 103,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4066620126"
			},
			{
				"title": "207736.法单简约羊毛外套\n",
				"num_iid": 4248205377,
				"price": 680,
				"orginal_price": 680,
				"promotion_price": 680,
				"pic_url": "https://si.geilicdn.com/wdseller901353083325-3c3d000001766f619c8a0a21348d-unadjust_1080_1440.jpeg",
				"sales": 1,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4248205377"
			},
			{
				"title": "小众单！全羊毛的羊羔毛笑脸连帽/立领外套",
				"num_iid": 4257140545,
				"price": 645,
				"orginal_price": 645,
				"promotion_price": 645,
				"pic_url": "https://si.geilicdn.com/weidian1221105613-33190000017690d62d610a21348d_733_727.jpg",
				"sales": 0,
				"seller_id": "",
				"seller_nick": "",
				"detail_url": "https://weidian.com/item.html?itemID=4257140545"
			},
		

 异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "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": "taobao",
  "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	未知错误	否