数据获取系列，按关键词搜索API接口

程序猿爱开发Anzexi58
94 阅读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": 12,
		"pagecount": "100",
		"data_from": "ti",
		"item": [
			{
				"title": "ONLY2022秋季新款假两件拼接设计宽松卫衣女【复古学院风系列】",
				"pic_url": "http://gw.alicdn.com/i1/356060330/O1CN01d5YjAD1EJBVa2PmoZ-356060330.jpg",
				"promotion_price": "399.0",
				"price": "399.0",
				"sales": 229,
				"num_iid": "677995481427",
				"seller_nick": "ONLY官方旗舰店",
				"seller_id": "356060330",
				"detail_url": "https://item.taobao.com/item.htm?id=677995481427"
			},
			{
				"title": "拉夏贝尔加绒卫衣女秋冬酒红色加厚羊羔绒女装兔年本命年衣服女X",
				"pic_url": "http://gw.alicdn.com/i1/2207860246915/O1CN01Sre1Oa20x7al5wrCH_!!0-item_pic.jpg",
				"promotion_price": "109.0",
				"price": "109.0",
				"sales": 1276,
				"num_iid": "693634994513",
				"seller_nick": "lachapellesport旗舰店",
				"seller_id": "2207860246915",
				"detail_url": "https://item.taobao.com/item.htm?id=693634994513"
			},
			{
				"title": "雪尼尔阔腿裤女秋冬2022年新款高腰垂感直筒加绒白色灯芯绒休闲裤",
				"pic_url": "http://gw.alicdn.com/i1/2132122429/O1CN01EAKZsi1ToWl7zy4Do_!!0-item_pic.jpg",
				"promotion_price": "71.2",
				"price": "71.2",
				"sales": 2111,
				"num_iid": "656934651220",
				"seller_nick": "兰梦娅旗舰店",
				"seller_id": "2132122429",
				"detail_url": "https://item.taobao.com/item.htm?id=656934651220"
			},
			{
				"title": "中老年40岁50妈妈风衣高贵秋装洋气中年女装春秋气质外套阔太太",
				"pic_url": null,
				"promotion_price": "388.0",
				"price": "388.0",
				"sales": 0,
				"num_iid": "624388625948",
				"seller_nick": null,
				"seller_id": "2200594381768",
				"detail_url": "https://item.taobao.com/item.htm?id=624388625948"
			},
			{
				"title": "黑色喇叭裤女秋冬高腰显瘦西装阔腿裤子春秋休闲加绒小个子微喇裤",
				"pic_url": "http://gw.alicdn.com/i2/3548913011/O1CN019NVZ5h1Y75KjmycyH_!!0-item_pic.jpg",
				"promotion_price": "129.0",
				"price": "129.0",
				"sales": 470,
				"num_iid": "684071431553",
				"seller_nick": "灰喵旗舰店",
				"seller_id": "3548913011",
				"detail_url": "https://item.taobao.com/item.htm?id=684071431553"
			},
			{
				"title": "春装2023新款假两件连帽卫衣长袖针织连衣裙子女装学院风收腰长裙",
				"pic_url": "http://gw.alicdn.com/i2/2209416033/O1CN014J7TTP1uRAGzTCNwE_!!0-item_pic.jpg",
				"promotion_price": "79.9",
				"price": "79.9",
				"sales": 242,
				"num_iid": "683618840373",
				"seller_nick": "季妃旗舰店",
				"seller_id": "2209416033",
				"detail_url": "https://item.taobao.com/item.htm?id=683618840373"
			},
			{
				"title": "麦穗雪尼尔阔腿裤女秋冬季加绒加厚高个子女装175穿搭170加长裤子",
				"pic_url": "http://gw.alicdn.com/i3/1579139371/O1CN01uPGp272J5yKKVuc6v_!!0-item_pic.jpg",
				"promotion_price": "54.8",
				"price": "54.8",
				"sales": 144,
				"num_iid": "693653157811",
				"seller_nick": "雅羊人旗舰店",
				"seller_id": "1579139371",
				"detail_url": "https://item.taobao.com/item.htm?id=693653157811"
			},
			{
				"title": "大码弹力直筒裤女胖mm黑色微喇叭梨型身材春季微胖显瘦穿搭牛仔裤",
				"pic_url": null,
				"promotion_price": "199.0",
				"price": "199.0",
				"sales": 0,
				"num_iid": "693591066648",
				"seller_nick": null,
				"seller_id": "2210502321590",
				"detail_url": "https://item.taobao.com/item.htm?id=693591066648"
			},
			{
				"title": "美式复古oversize白色连帽卫衣女秋冬2023年新款春装短款长袖上衣",
				"pic_url": "http://gw.alicdn.com/i2/2213288309/O1CN010gamaZ2BFZigkjYhB_!!2213288309.jpg",
				"promotion_price": "69.9",
				"price": "69.9",
				"sales": 108,
				"num_iid": "696922208941",
				"seller_nick": "卡拉尔贝齐旗舰店",
				"seller_id": "2213288309",
				"detail_url": "https://item.taobao.com/item.htm?id=696922208941"
			},
			{
				"title": "新年红色针织衫毛衣女秋冬中长款兔年2023新款上衣洋气内搭打底衫",
				"pic_url": "http://gw.alicdn.com/i2/3462705088/O1CN01kA47iq1nSLzB4VH29_!!0-item_pic.jpg",
				"promotion_price": "99.0",
				"price": "99.0",
				"sales": 1582,
				"num_iid": "696099460988",
				"seller_nick": "喜蝶诗旗舰店",
				"seller_id": "3462705088",
				"detail_url": "https://item.taobao.com/item.htm?id=696099460988"
			},
			{
				"title": "白色灯芯绒阔腿裤女春秋高腰垂感宽松休闲直筒秋冬加绒雪尼尔裤子",
				"pic_url": "http://gw.alicdn.com/i3/2098049097/O1CN01k22kaz2H4TmtAEGfB_!!0-item_pic.jpg",
				"promotion_price": "68.0",
				"price": "68.0",
				"sales": 22078,
				"num_iid": "682700458130",
				"seller_nick": "比丽福旗舰店",
				"seller_id": "2098049097",
				"detail_url": "https://item.taobao.com/item.htm?id=682700458130"
			},
			{
				"title": "黑色直筒牛仔裤女秋冬季加绒大码胖mm弹力显瘦遮胯设计感微喇叭裤",
				"pic_url": null,
				"promotion_price": "199.0",
				"price": "199.0",
				"sales": 0,
				"num_iid": "691797073130",
				"seller_nick": null,
				"seller_id": "2210502321590",
				"detail_url": "https://item.taobao.com/item.htm?id=691797073130"
			}
		],
		"item_weight_update": 0
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a8881ed5637e3c7e84f03acdc86be64f",
	"secache_time": 1675045058,
	"secache_date": "2023-01-30 10:17:38",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:14 max:10100 all[30=14+2+14];expires:2030-12-31",
	"execution_time": "1.472",
	"server_time": "Beijing/2023-01-30 10:17:38",
	"client_ip": "220.177.180.18",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_api",
	"server_memory": "6.03MB",
	"request_id": "gw-1.63d728c14261f",
	"last_id": "1507369609"
}
avatar
文章
阅读
粉丝