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

程序猿爱开发Anzexi58
112 阅读4分钟

onebound.taobao.item_search

公共参数

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

名称类型必须描述
keyString是调用key（必须以GET方式拼接在URL中）
secretString是调用密钥
api_nameString是API接口名称（包括在请求地址中）[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简体中文
versionString否API版本

请求参数

请求参数：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": 2000,
		"total_results": 2000,
		"page_size": 10,
		"pagecount": "100",
		"data_from": "ti",
		"item": [
			{
				"title": "UR新品女装轻熟风百褶宽松中高腰长裙WG38S5AN2007",
				"pic_url": "http://gw.alicdn.com/i3/2104668892/O1CN011WBE0d2FYacnS64Rb_!!2104668892.jpg",
				"promotion_price": "399.0",
				"price": "399.0",
				"sales": 138,
				"num_iid": "682491173051",
				"seller_nick": "UR官方旗舰店",
				"seller_id": "2104668892",
				"detail_url": "https://item.taobao.com/item.htm?id=682491173051"
			},
			{
				"title": "UR2022冬季新款女装气质小众流苏厚款高领毛衣WL45S9BN2002",
				"pic_url": "http://gw.alicdn.com/i4/2104668892/O1CN01nSkEpT2FYacenCvcr_!!2104668892.jpg",
				"promotion_price": "399.0",
				"price": "399.0",
				"sales": 327,
				"num_iid": "685038470534",
				"seller_nick": "UR官方旗舰店",
				"seller_id": "2104668892",
				"detail_url": "https://item.taobao.com/item.htm?id=685038470534"
			},
			{
				"title": "ONLY2022秋季新款假两件拼接设计宽松卫衣女【复古学院风系列】",
				"pic_url": "http://gw.alicdn.com/i1/356060330/O1CN01AAwpFb1EJBVWl3Tlu-356060330.jpg",
				"promotion_price": "399.0",
				"price": "399.0",
				"sales": 198,
				"num_iid": "677995481427",
				"seller_nick": "ONLY官方旗舰店",
				"seller_id": "356060330",
				"detail_url": "https://item.taobao.com/item.htm?id=677995481427"
			},
			{
				"title": "秋冬折扣Massimo Dutti女装 休闲版型牛仔阔腿短裤 05003403800",
				"pic_url": "http://gw.alicdn.com/i3/2183380830/O1CN01OE1kYa1I0BUaj6uCs_!!0-item_pic.jpg",
				"promotion_price": "450.0",
				"price": "450.0",
				"sales": 34,
				"num_iid": "675002026149",
				"seller_nick": "Massimo Dutti官方旗舰店",
				"seller_id": "2183380830",
				"detail_url": "https://item.taobao.com/item.htm?id=675002026149"
			},
			{
				"title": "【春节限定系列】AF女装 时尚睫毛纱修身舒适V领开衫 323974-1",
				"pic_url": "http://gw.alicdn.com/i3/3316585763/O1CN01p9dQgB1sRVKhEhPBD_!!3316585763.jpg",
				"promotion_price": "590.0",
				"price": "590.0",
				"sales": 65,
				"num_iid": "694519731501",
				"seller_nick": "Abercrombie & Fitch官方旗舰店",
				"seller_id": "3316585763",
				"detail_url": "https://item.taobao.com/item.htm?id=694519731501"
			},
			{
				"title": "灯芯绒阔腿裤女秋冬季2022年新款高腰白色加绒雪尼尔直筒休闲裤子",
				"pic_url": "http://gw.alicdn.com/i1/3937219703/O1CN01RCArIx2LY1pXlZ7eM_!!3937219703-0-C2M.jpg",
				"promotion_price": "55.35",
				"price": "55.35",
				"sales": 7944,
				"num_iid": "687921206913",
				"seller_nick": "天天特卖工厂店",
				"seller_id": "3937219703",
				"detail_url": "https://item.taobao.com/item.htm?id=687921206913"
			},
			{
				"title": "NASA联名草莓熊卫衣女纯棉加绒新款春秋冬小众慵懒风连帽外套女装",
				"pic_url": "http://gw.alicdn.com/i3/3937219703/O1CN011quXP12LY1ou80Fzf_!!3937219703-0-C2M.jpg",
				"promotion_price": "111.84",
				"price": "111.84",
				"sales": 2344,
				"num_iid": "692375040884",
				"seller_nick": "天天特卖工厂店",
				"seller_id": "3937219703",
				"detail_url": "https://item.taobao.com/item.htm?id=692375040884"
			},
			{
				"title": "Lauren/拉夫劳伦女装 2022年秋冬修身版粗花呢西装外套RL61219",
				"pic_url": "http://gw.alicdn.com/i4/3315538487/O1CN01cQPKJR2CZ6DQjDxeO_!!3315538487.jpg",
				"promotion_price": "3790.0",
				"price": "3790.0",
				"sales": 4,
				"num_iid": "684892541854",
				"seller_nick": "RALPH LAUREN官方旗舰店",
				"seller_id": "3315538487",
				"detail_url": "https://item.taobao.com/item.htm?id=684892541854"
			},
			{
				"title": "蓝色加绒雪尼尔阔腿裤女秋冬季2022年新款高腰垂感休闲直筒针织裤",
				"pic_url": "http://gw.alicdn.com/i1/1704328704/O1CN01IJjYZJ2EAU9iJsgHE_!!0-item_pic.jpg",
				"promotion_price": "60.0",
				"price": "60.0",
				"sales": 11470,
				"num_iid": "694181101979",
				"seller_nick": "衣梵诗旗舰店",
				"seller_id": "1704328704",
				"detail_url": "https://item.taobao.com/item.htm?id=694181101979"
			},
			{
				"title": "优衣库 女装 柔软针织摇粒绒圆领套头衫(长袖抓绒内搭外穿)450415",
				"pic_url": "http://gw.alicdn.com/i3/196993935/O1CN01NfSyeF1ewHKHp9apa_!!0-item_pic.jpg",
				"promotion_price": "59.0",
				"price": "59.0",
				"sales": 5249,
				"num_iid": "682029241336",
				"seller_nick": "优衣库官方旗舰店",
				"seller_id": "196993935",
				"detail_url": "https://item.taobao.com/item.htm?id=682029241336"
			}
		],
		"item_weight_update": 0
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a8881ed5637e3c7e84f03acdc86be64f",
	"secache_time": 1673858880,
	"secache_date": "2023-01-16 16:48:00",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:65 max:10100 all[164=65+65+34];expires:2030-12-31",
	"execution_time": "1.421",
	"server_time": "Beijing/2023-01-16 16:48:00",
	"client_ip": "106.6.34.13",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "5.99MB",
	"request_id": "gw-3.63c50f3eaa0c2",
	"last_id": "1479213510"
}
avatar
文章
阅读
粉丝