万邦淘宝/天猫按关键字搜索淘宝商品 API 返回值说明

124 阅读6分钟

onebound.taobao.item_search

公共参数

请求地址:console.open.onebound.cn/console/?i=…

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明:q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数

响应参数

Version: Date:

名称类型必须示例值描述
titleString0法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装商品标题
pic_urlString0//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg宝贝图片
promotion_priceFloat0178.00优惠价
priceFloat0178.00价格
salesInt0890销量
num_iidBigint0577437133060宝贝ID
sample_idString0商品风格标识ID
seller_nickString0初穆旗舰店掌柜昵称
post_feeFloat010.00物流费用
areaString0山东店铺所在地
detail_urlString0//detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0宝贝链接
seller_infoMix0{"level": 99, "shop_type": "B", "user_num_id": "2217148345", "cid": 0, "delivery_score": "", "item_score": "", "score_p": ""}卖家信息

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="

响应示例

	"items": {
		"page": "1",
		"real_total_results": 913989,
		"total_results": 2000,
		"page_size": 20,
		"pagecount": 100,
		"data_from": "ti",
		"item": [
			{
				"title": "韩国chic秋冬复古小个子V领修身打底针织连衣裙女内搭毛衣包臀裙",
				"pic_url": "//img.alicdn.com/bao/uploaded/i3/883880594/O1CN01gfGYXw1GG5z8JatYz_!!883880594.png",
				"promotion_price": "39.98",
				"price": "39.98",
				"sales": 8000,
				"num_iid": "662598791027",
				"seller_nick": "彤宝宝20086",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=662598791027"
			},
			{
				"title": "秋冬季特价女装羽绒棉服女中长款毛呢外套加厚棉衣女毛衣套装清仓",
				"pic_url": "//img.alicdn.com/bao/uploaded/i1/2212828608196/O1CN01XEcPNq2APoxCnPqer_!!2212828608196.jpg",
				"promotion_price": "19.80",
				"price": "19.80",
				"sales": 8000,
				"num_iid": "693221861929",
				"seller_nick": "tb8466940885",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=693221861929"
			},
			{
				"title": "皮毛一体羊羔毛毛外套女秋冬季麂鹿皮绒机车服夹克高级感大衣女装",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/852258787/O1CN01GP2wJK2EmV20HhIm3_!!852258787.jpg",
				"promotion_price": "269.00",
				"price": "269.00",
				"sales": 8000,
				"num_iid": "679991464592",
				"seller_nick": "wow芭拉芭拉",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=679991464592"
			},
			{
				"title": "纯棉黑白色小吊带打底背心女款内搭秋冬加绒保暖美背上衣网红超火",
				"pic_url": "//img.alicdn.com/bao/uploaded/i1/2200711151795/O1CN011D21ra1P89jb0kOfb_!!0-item_pic.jpg",
				"promotion_price": "29.00",
				"price": "29.00",
				"sales": 6000,
				"num_iid": "693979627066",
				"seller_nick": "南极人女装旗舰",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=693979627066"
			},
			{
				"title": "女装连衣裙半身裙直播拍卖",
				"pic_url": "//img.alicdn.com/bao/uploaded/i2/2522350351/O1CN01fA86Hu1ESniNTqNXL_!!2522350351.jpg",
				"promotion_price": "12.90",
				"price": "12.90",
				"sales": 6000,
				"num_iid": "652901147276",
				"seller_nick": "武林盟主vsxiao",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=652901147276"
			},
			{
				"title": "【惊喜盲盒】A•B恋源 年终回馈~ A•BHYB230103S",
				"pic_url": "//img.alicdn.com/bao/uploaded/i3/2213240923954/O1CN01LO697t1f4yqhpU1X5_!!2213240923954.jpg",
				"promotion_price": "69.99",
				"price": "69.99",
				"sales": 4000,
				"num_iid": "696259877740",
				"seller_nick": "tb9642106341",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=696259877740"
			},
			{
				"title": "加绒吊带背心女内搭新款2022爆款冬季保暖遮副乳白色西装打底上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/885825895/O1CN01yK1ijY1tPxaYRbOw4_!!885825895.jpg",
				"promotion_price": "29.80",
				"price": "29.80",
				"sales": 4000,
				"num_iid": "683666948152",
				"seller_nick": "冷冷冷冷的咖啡",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=683666948152"
			},
			{
				"title": "【惊喜盲盒】A•B恋源  ~ A•BX230103A",
				"pic_url": "//img.alicdn.com/bao/uploaded/i1/2213240923954/O1CN01nZZm6V1f4yqnk7ffA_!!2213240923954.jpg",
				"promotion_price": "299.00",
				"price": "299.00",
				"sales": 4000,
				"num_iid": "695941164858",
				"seller_nick": "tb9642106341",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=695941164858"
			},
			{
				"title": "德绒吊带保暖内衣女士内搭自发热加绒背心打底衫带胸垫一体秋冬季",
				"pic_url": "//img.alicdn.com/bao/uploaded/i2/2200711151795/O1CN01izW8AT1P89iwhTEVj_!!0-item_pic.jpg",
				"promotion_price": "39.00",
				"price": "39.00",
				"sales": 3000,
				"num_iid": "686753472489",
				"seller_nick": "南极人女装旗舰",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=686753472489"
			},
			{
				"title": "护腰护肚双面德绒发热保暖背心无痕背心女秋冬加绒吊带修身保暖",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/3301871646/O1CN01b1cqrS1O1udqPQ1kV_!!3301871646.jpg",
				"promotion_price": "14.50",
				"price": "14.50",
				"sales": 2000,
				"num_iid": "660299976279",
				"seller_nick": "mg棒棒唐",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=660299976279"
			},
			{
				"title": "郑菲菲自制【束腹显瘦】高级感黑灰色超高腰九分毛边小脚牛仔裤女",
				"pic_url": "//img.alicdn.com/bao/uploaded/i3/100390317/O1CN01s14Obk1EDEFW89jDu_!!100390317.jpg",
				"promotion_price": "139.00",
				"price": "139.00",
				"sales": 2000,
				"num_iid": "651274244703",
				"seller_nick": "快乐的猪mm",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=651274244703"
			},
			{
				"title": "粉色高领毛衣女秋冬加厚2022年新款羊绒针织衫打底衫内搭洋气上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i2/3037915767/O1CN01Mm3VZG1sTKttoZwFG_!!3037915767.jpg",
				"promotion_price": "16.80",
				"price": "16.80",
				"sales": 2000,
				"num_iid": "688781354880",
				"seller_nick": "小蚊子实力服装店",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=688781354880"
			},
			{
				"title": "保暖吊带小背心女装秋冬季内搭加绒加厚针织打底衫早秋衣无袖上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/4023193621/O1CN01k5vHFR1ccSwJxVYAv_!!0-item_pic.jpg",
				"promotion_price": "12.90",
				"price": "12.90",
				"sales": 2000,
				"num_iid": "687234954784",
				"seller_nick": "tb804634492",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=687234954784"
			},
			{
				"title": "保暖吊带小背心女装秋冬季内搭加绒加厚针织打底衫早秋衣无袖上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/4023193621/O1CN01k5vHFR1ccSwJxVYAv_!!0-item_pic.jpg",
				"promotion_price": "9.95",
				"price": "9.95",
				"sales": 1000,
				"num_iid": "687163590787",
				"seller_nick": "沿花小筑旗舰店",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=687163590787"
			},
			{
				"title": "白色吊带背心女西装内搭冬季加绒设计感小众保暖打底黑色方领上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i1/885825895/O1CN01EaUBUx1tPxXf4pkX9_!!885825895.jpg",
				"promotion_price": "28.80",
				"price": "28.80",
				"sales": 1000,
				"num_iid": "666378312752",
				"seller_nick": "冷冷冷冷的咖啡",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=666378312752"
			},
			{
				"title": "adidas阿迪达斯官方女装户外运动600蓬保暖鸭绒面包羽绒服HA1176",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/446338500/O1CN01aTMunp2Cf3MZNR76z_!!446338500.jpg",
				"promotion_price": "1499.00",
				"price": "1499.00",
				"sales": 1000,
				"num_iid": "657698091286",
				"seller_nick": "adidas官方旗舰店",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=657698091286"
			},
			{
				"title": "2020吊带背心女加绒加厚新款蕾丝内搭修身无钢圈保暖上衣打底衫女",
				"pic_url": "//img.alicdn.com/bao/uploaded/i3/2200824665381/O1CN01wrknPT1pcXrOGoSWb_!!0-item_pic.jpg",
				"promotion_price": "13.89",
				"price": "13.89",
				"sales": 1000,
				"num_iid": "650037088616",
				"seller_nick": "tb096225082",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=650037088616"
			},
			{
				"title": "软糯舒适/半高领加绒加厚德绒打底衫女秋冬内搭长袖百搭显瘦上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i2/2313923458/O1CN01AsUOTO1bPoEc9rgJc_!!2313923458.jpg",
				"promotion_price": "55.00",
				"price": "55.00",
				"sales": 1000,
				"num_iid": "632369217085",
				"seller_nick": "nomi汤圆",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=632369217085"
			},
			{
				"title": "红色圣诞麻花毛衣女加厚秋冬爆款外穿宽松慵懒风中长款软糯针织衫",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/2452197106/O1CN01m7SMuH22MbErnBULL_!!2452197106.jpg",
				"promotion_price": "39.90",
				"price": "39.90",
				"sales": 1000,
				"num_iid": "693431406799",
				"seller_nick": "杨晓娜806188008",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=693431406799"
			},
			{
				"title": "加绒背心女冬季加厚保暖西装内搭新款2022爆款白色打底设计感上衣",
				"pic_url": "//img.alicdn.com/bao/uploaded/i4/885825895/O1CN01PfC4bh1tPxaY08GS5_!!885825895.jpg",
				"promotion_price": "39.90",
				"price": "39.90",
				"sales": 1000,
				"num_iid": "683665120929",
				"seller_nick": "冷冷冷冷的咖啡",
				"seller_id": null,
				"detail_url": "https://item.taobao.com/item.htm?id=683665120929"
			}
		],
		"item_weight_update": 0
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a8881ed5637e3c7e84f03acdc86be64f",
	"secache_time": 1672812426,
	"secache_date": "2023-01-04 14:07:06",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:37 max:10000 all[131=37+65+29];expires:2030-12-31",
	"execution_time": "1.975",
	"server_time": "Beijing/2023-01-04 14:07:06",
	"client_ip": "106.6.36.102",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "6MB",
	"request_id": "gw-1.63b51788461e5",
	"last_id": "1454358743"
}